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Preface 



Manual Objectives 

This manual contains information about operating the RSX-llM-PLUS and Micro/RSX error 
logging system. It explains how the Error Logger collects information on system events and 
errors and how the Report Generator and control file produce various kinds of reports on those 
events and errors. It also includes information on the control file architecture and on how to 
add user-written modules. The error logging system allows you to monitor the reliability of 
the hardware on your system by setting error limits and displaying messages on the console 
terminal if the number of errors on a device exceeds those limits. 

Intended Audience 

This manual is intended for Field Service personnel, system managers, and others responsible for 
maintaining the integrity of hardware devices connected to an RSX-llM-PLUS or Micro/RSX 
operating system. 

In addition to understanding the RSX-llM-PLUS or Micro/RSX operating system and the 
error logging system, you need a thorough knowledge of the hardware devices that the error 
logging system is monitoring. This manual does not attempt to describe or explain the hardware 
information that appears in the error log reports. For information about a specific device, consult 
the hardware documentation for that device. 

Structure of This Document 

Chapter 1 provides an overview of the purpose and function of the error logging system. 
It describes some features and limitations of the system and explains the operating system 
resources that error logging requires. 

Chapter 2 describes the procedures for operating the Error Logger and explains the Error Log 
Interface (ELI) commands to control logging and limiting. 

Chapter 3 describes the procedures for operating the Report Generator task (RPT) and describes 
the report formatting that is available. 
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Chapter 4 explains the control file modules in detail, including the flow of program control, 
interfaces between modules, and module dispatching. A knowledgeable system programmer 
can use the information presented to add user-written modules to the error logging system. The 
chapter includes extensively annotated examples of DIGITAL-supplied modules. 

Chapter 5 describes the Control File Language (CFL), which is used to write control file modules. 

Appendix A describes the indirect command file, TUNE.CMD, that you can use to remove 
devices from the error logging universal library and make it smaller. 

Appendix B describes the formats used for drive serial numbers on DIGITAL devices. 

Appendix C describes the formats for standard error log subpackets. 

Associated Documents 

This manual assumes you are familiar with the following documents: 

• The RSX-1 IM-PLUS Command Language Manual 

• The Micro/RSX User's Guide 

The RSX-llM-PLUS Information Directory and Master Index defines the intended readership for 
each manual in the documentation set and provides a synopsis of each manual's contents. 
When this manual refers to other documents, consult the appropriate information directory for 
information about the document. 

Conventions Used in Tiiis Document 

The following conventions are used in this manual: 



Convention 



Meaning 



> 



xxx> 
UPPERCASE 



A right angle bracket is the default prompt for the Monitor 
Console Routine (MCR), which is one of the command interfaces 
used on RSX-llM-PLUS systems. All systems include MCR. 

A dollar sign followed by a space is the default prompt of 
the DIGITAL Command Language (DCL), which is one of the 
command interfaces used on RSX-llM-PLUS and Micro/RSX 
systems. Many systems include DCL. 

Three characters followed by a right angle bracket indicate the 
explicit prompt for a task, utility, or program on the system. 

Uppercase letters in a command line indicate letters that must be 
entered as they are shown. For example, utility switches must 
always be entered as they are shown in format specifications. 
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Convention 



Meaning 



command abbreviations 



Where short forms of commands are allowed, the shortest form 
acceptable is represented by uppercase letters. The following 
example shows the minimum abbreviation allowed for the DCL 
command DIRECTORY: 

$ DIR 



lowercase 



/keyword, 
/qualifier, 
or 
/switch 

parameter 

[option] 



1-] 



{} 

: argument 



Any command in lowercase must be substituted for. Usually 
the lowercase word identifies the kind of substitution expected, 
such as a filespec, which indicates that you should fill in a file 
specification. For example: 

filename . filet ype ; version 

This command indicates the values that make up a file 
specification; values are substituted for each of these variables 
as appropriate. 

A command element preceded by a slash (/) is an MCR 
keyword; a DCL qualifier; or a task, utility, or program switch. 

Keywords, qualifiers, and switches alter the action of the 
command they follow. 

Required command fields are generally called parameters. The 
most common parameters are file specifications. 

Square brackets indicate optional entries in a command line or 
a file specification. If the brackets include syntactical elements, 
such as periods ( . ) or slashes ( / ), those elements are required 
for the field. If the field appears in lowercase, you are to 
substitute a valid command element if you include the field. 
Note that when an option is entered, the brackets are not 
included in the command line. 

Square brackets around a comma and an ellipsis mark indicate 
that you can use a series of optional elements separated 
by commas. For example, (argument, [,...]) means that you 
can specify a series of optional arguments by enclosing the 
arguments in parentheses and by separating them with commas. 

Braces indicate a choice of required options. You are to choose 
from one of the options listed. 

Some parameters and qualifiers can be altered by the inclusion 
of arguments preceded by a colon. An argument can be either 
numerical (C0PIES:3) or alphabetical (NAME:Q1X). In DCL, the 
equal sign (=) can be substituted for the colon to introduce 
arguments. COPIES=3 and COPlES:3 are the same. 
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Convention 



Meaning 



() 



[directory] 



Parentheses are used to enclose more than one argument in a 
command line. 

SET PROT = (S:RWED,0:RWED) 

Commas are used as separators for command line parameters 
and to indicate positional entries on a command line. Positional 
entries are those elements that must be in a certain place in the 
command line. Although you might omit elements that come 
before the desired element, the commas that separate them must 
still be included. 

The convention [g,m] signifies a User Identification Code (UIC). 
The g is a group number and the m is a member number. The 
UIC identifies a user and is used mainly for controlling access 
to files and privileged system functions. 

This may also signify a User File Directory (UFD), commonly 
called a directory. A directory is the location of files. 

Other notations for directories are: [ggg,m], [gggmmm], [ufd], 
[name], and [directory]. 

The convention [directory] signifies a directory. Most directories 
have 1- to 9-character names, but some are in the same [g,m] 
form as the UIC. 

Where a UIC, UFD, or directory is required, only one set of 
brackets is shown (for example, [g,m]). Where the UIC, UFD, 
or directory is optional, two sets of brackets are shown (for 
example, [[g,m]]). 

A vertical ellipsis shows where elements of command input or 
statements in an example or figure have been omitted because 
they are irrelevant to the point being discussed. 



KEYNAME 
"print" and "type" 

black ink 
red ink 



This typeface denotes one of the keys on the terminal keyboard; 
for example, the RETURN key. 

The term "print" refers to any output sent to a terminal by 
the system. The term "type" refers to any user input from a 
terminal. 

In examples, what the system prints or displays is printed in 
black. 

In interactive examples, what the user types is printed in red. 
System responses appear in black. 
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Summary of Technical Changes 



The following sections list features, qualifiers, and restrictions that are new to the error logging 
system or have been modified for the RSX-llM-PLUS and Micro/RSX Version 4.0 operating 
systems. These new or modified features are documented in this revision of the RSX-1 IM-PLUS 
and Micro/RSX Error Logging Manual. 

New Hardware Support 

RSX-llM-PLUS and Micro/RSX Version 4.0 support the following new hardware: 

• The PDP-11/73, PDP-11/83, and PDP-11/84 processors 

• The RA70, RD52, RD53, RD54, and RX33 disk drives 

• The TK50 and TU81E tape drives 

New or Modified Features 

The error logging system has the following new or modified features: 

• Internal I/O Features 

• Non-DIGITAL Device Recognition 

• Error Logging Control Files 

• DCL Support for ELI and RPT Commands 

• Independent Hard and Soft Limits 

• New Control File Modules 

Internal I/O Features 

The error logging system supports error logging for internal I/O operations such as data caching. 
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Non-DIGITAL Device Recognition 

You no longer need to add a record to the DEVICE _INFO table in the DEVSMl module for 
the error logging system to recognize a user-written device level module. After you write the 
device level module for your devices, compile the module or modules with the DSP2P1.SYM 
file. Next, insert your module in ERRLOG.ULB. The name of a user-written module must be in 
the following form: 

ExxUSR 

The letters xx stand for the device mnemonic. Your device mnemonic cannot be the same as 
any DIGITAL-supplied device mnemonic. 

Specify your module name in the MODULE statement as follows: 

MODULE ExxUSR 

In your module, you must set the variable INDICATE.TAPE_FLAG to false if the device you 
specify is a disk. 

If the device you specify is not a disk, set the variable INDICATE.TAPE_FLAG to true. 

Remember to set your INTERMOD_DEVERR variables accordingly. 

If there is a NOTES module, its name must be in the following form: 

NxxUSR 

DCL Support for ELI and RPT Commands 

The ELI and RPT commands can be entered at the DCL level. This manual documents the DCL 
command equivalent for each MCR-level ELI and RPT command. 

independent Hard and Soft Limits 

Error logging allows hard and soft error limits to be reached independently. Previously, reaching 
one of the limits would disable logging of either kind of error on that device. Now, reaching 
the soft limit does not affect the logging of hard errors and vice versa. 

Device timeouts are logged as hard errors if unrecoverable and as soft errors if recoverable. 

New Control File Modules 

The error logging system contains the following new control file modules: 

• The DSP8P1 dispatcher module for CPU-detected errors 

• The E118x CPU-level module to process memory parity errors for the PDP-11/73, 
PDP-11/83, and PDP-11/84 processors 
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New or Modified Qualifiers 

The DCL ELI command SHOW ERROR—LOG displays error logging information for the specified 
device or, if you do not specify a device, displays error logging information for all devices. 

Micro/RSX supports the following qualifiers for the SHOW ERROR_LOG command: 

• /CURRENT 

• /HISTORY 

• /NEW 

The qualifiers for the SHOW ERROR _LOG command have the following functions: 

/CURRENT 

Displays errors that have occurred on all devices since the last time the error logging 
system was started using the /UPDATE or /ZERO switch. This qualifier provides the same 
functionality as the MCR ELl/SH/CU command. 

/HISTORY 

Displays a summary of errors that have occurred on all devices since the last time the error 
logging system was started using the /ZERO qualifier. This qualifier provides the same 
functionality as the MCR ELI/SH/HI command. 

/RECENT 

Displays a brief description of errors (in chronological order) that have been recorded by the 
error logging system. This qualifier provides the same functionality as the MCR ELI/SH/NE 
command. 

New Error Messages 

The Report Generator task (RPT) uses the following new error messages: 

• ERLCNF-F-ILLPACSPC 

• ERLRPT-F-FORINVCHR 

ERLCNF-F-ILLPACSPC 

ERLCNF-F-ILLPACSPC occurs when you use an invalid packet specification with an RPT 
report-generating command. 

ERLRPT-F-FORINVCHR 

ERLRPT-F-FORINVCHR occurs when a control file module executes a WRITE or WRITE- 
GROUP statement with a !DP directive that contains an invalid character. 
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Restriction 

Error logging has the following restriction: 

Data Subpacket Address Restriction 

Because the error logging routines have been moved to the Executive common, the following 
restriction now applies: if a driver of an error logging device calls the $CRPKT routine to create 
an error logging packet, the data address for the data subpacket must not be an address within 
the driver. Specifically, the address must not be mapped by APR 5, as this APR is used to map 
the common. Any user-written driver that performs such a function must allocate a piece of 
pool, fill in the appropriate information, and pass the pool address to the Create Packet routine. 



xvtii 



Chapter 1 
Introduction 



The RSX-llM-PLUS and Micro/RSX error logging system records information about errors and 
events that occur on your system hardware, either for immediate action or for later analysis and 
reporting. Error logging handles mass storage device (disk and tape) errors, as well as memory 
errors. Since error logging is a part of the RSX-llM-PLUS and Micro/RSX operating systems, 
it is most effective for hardware errors that allow the system to continue functioning. 

Error logging is not used to detect information about operating system failures or about device 
problems that cause the system to fail. However, it does provide information about what I/O 
activities occurred on a device at the time of an I/O failure, and it detects errors in internal 
I/O operations such as data caching. If your system includes the Crash Dump Analyzer (CD A), 
CDA can provide reports on operating system failures. 

You can use error log reports to determine that a device is having problems before the device 
actually fails and causes you to lose data. For example, a report showing a pattern of recurring 
errors from different blocks on a single disk head may indicate that the head needs to be 
replaced. 

1 . 1 Error Logging Operation 

The complete error logging system is composed of the following four tasks: 

• The Error Logger (ERRLOG) 

• The Error Log Interface (ELI) 

• The Report Generator (RPT) 

• The Control File Language (CFL) compiler 

When the Executive or a device driver detects an error. Executive routines create an error log 
packet in pool to describe the event. (See Appendix C for a description of the error log packet.) 
ERRLOG then writes the packet from pool into the error log file on disk, usually within a few 
seconds of when the packet is created. 

Figure 1-1 shows the interaction of the error logging system tasks with routines in the Executive. 
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ERRLOG receives user commands from the Error Log Interface (ELI) to control ERRLOG 
operation. These commands send error log packets called command packets to the ERRLOG 
task. 

The Report Generator (RPT) generates reports from the information in the error log file. 

RPT uses a library of modules written in the Control File Language (CFL) to interpret data 
from the error log file and from user commands. The CFL compiler is also part of the error 
logging system. You can use CFL to recompile DIGITAL-supplied control file modules to include 
patches to the modules supplied in the future. You can also use CFL to create and compile 
control file modules for devices other than those DIGITAL supplies. Chapter 4 explains the 
control file module architecture and includes annotated DIGITAL control file modules. Chapter 
5 documents the Control File Language. 

1.1.1 Executive Routines 

Whenever the RSX-llM-PLUS or Micro/RSX system is running and error logging is active, 
routines in the Executive collect information from device drivers and other tasks and write the 
information into error log packets in system pool. 

The Executive gathers information on the state of the registers when a device error occurs, 
and includes information on system events such as device mounts and dismounts. You can 
also insert a text message into the error log file using the MCR command System Service 
Message (SSM) or the DCL command MESSAGE/ERROR_LOG. (See the RSX-UM-PLUS MCR 
Operations Manual.) 

If error logging is not active on the system, the device drivers still detect each hardware error, 
but the Executive does not create error log packets. 

The error logging system makes a distinction between hard errors and soft errors. Hard errors 
are those that cause an I/O operation to be aborted because the device driver cannot recover 
from the error. The task that issued the I/O request receives an error code indicating that the 
operation failed. Soft errors are those from which the device driver can recover. The task that 
issued the I/O request does not receive an error notification because the request eventually 
succeeds. 

The error logging system logs both hard and soft errors. Thus, you can have a system functioning 
properly, with no errors reported to any tasks in the system, with errors still being encountered 
and logged. For this reason, error logging terminology sometimes refers to errors as events; 
they do not always mean an actual failure. 

When error logging is active, the Executive writes the data from a single event into one error 
log packet and assigns a sequence number unique to that event to the packet. The Resource 
Monitoring Display (RMD) shows the highest assigned sequence number as ERRSEQ, the total 
number of errors since error logging operations began. 

When ERRLOG writes the packet in a file, the packet gets a number that describes its location in 
the file relative to other packets. RPT uses this number to refer to the event in later operations. 
The number does not change unless the organization of the file changes. For example, if an 
earlier error log file is appended to the current error log file, the packet numbers in the appended 
file will change. 



Introduction 1-3 



Thus, you can generate a brief format RPT report to determine the packet numbers of the most 
significant errors on your system, and then generate a full format report, by packet number, of 
only those errors. 

The Executive includes a directive for error logging (SMSG$) that sends error log packets directly 
to the Error Logger. (See the RSX-llM-PLUS and Micro/RSX Executive Reference Manual for an 
explanation of how to use this directive.) User tasks can use SMSG$ to communicate with the 
Error Logger. 

1.1.2 ERRLOGand ELI 

ERRLOG writes the error log packets from pool to the error log file in binary format. Only RPT 
can interpret and format data from the error log file. 

To issue a command to ERRLOG, type an ELI command to perform one of the ERRLOG functions 
(logging, limiting, or file naming). ELI sends an error log command packet to ERRLOG with 
instructions on the function to be performed, and ERRLOG returns the results, if any, to ELL 

The ERRLOG task allows you to specify two files to contain the error log packets written to 
disk. ERRLOG uses the first file, the error log file, unless an error is detected while ERRLOG 
writes to the file. If an error is detected, ERRLOG switches to the second file, the backup file. 
ELI commands allow you to establish or change the names of the error log file and backup file. 

The error logging system automatically limits the number of events it logs on a given device. 
This error limit can be changed dynamically by ELI commands while error logging is running. 
The system uses limits in case the device starts to accumulate a large number of errors. Without 
limits in these cases, the error log file would quickly become large and difficult to analyze. 
Error limiting does not lose useful information because, usually when a large number of events 
occurs on a device, most of them are the same and you can generalize from a report on a small 
number of the events. 

After a device reaches a particular error limit, logging of that tj^e of error on the device stops 
until you reset the error count to zero or raise the error limit. 

ERRLOG sends a message to the console terminal or to any terminal that has allocated the 
device, explaining that the device reached the error limit. Error limiting does not affect the 
operation of the device itself; it only starts or stops error logging on the device. 

1.1.3 RPT 

RPT creates reports on the data in the error log file, based on information in the error log 
control file and commands supplied by the user. Modules in the error log control file tell RPT 
how to interpret and print entries from the error log file for a specific operating system. 

When you are ready to generate an error log report, you can run RPT to select the information 
you want to include in the report. RPT can generate reports in brief and full format on any 
collection of error log packets you select. For example, you can select reports on a specific 
device by device name, device type, volume label, pack identification, or drive serial number. 
You can also select reports of a specific error type or you can select a full report of all the error 
log packets in the error log file. 

Error log reports can contain both context information and device-supplied information. 
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Context information, which appears in full format reports, contains operating system version 
information and some information about the CPU model. Context information on the I/O 
operation that encountered the failure is recorded for device errors. This information allows you 
to correlate events recorded in the error log file with other events in the system. For example, 
hard I/O errors often cause the task issuing the I/O request to exit with an error, since many 
tasks cannot recover from I/O errors. You can also use information about the I/O operation to 
determine what operation the device driver attempted at the time of the failure. 

Error logging records information on each I/O operation that takes place when an error occurs 
on other system error logging devices. This information is useful if you have a failure that may 
be related to interactions between devices. For example, I/O bus timing problems may show 
up as a problem only when more than one I/O operation takes place at the same time on the 
system. 

In a full report, RPT also includes all device-supplied information, including the status of registers 
and any other information the device provides. Each device supplies one or more machine 
words of information when an error occurs. RPT decodes each item of device information 
according to the terminology used in the device maintenance manual. Additional information 
may be listed in parentheses to help you understand the significance of a decoded item. 

In RPT reports, decoded items that are abnormal are flagged with an asterisk (*). These items 
may or may not represent error conditions, depending on the state of the device. You should 
interpret an asterisk flag as a "look at me first" message. RPT reports flag more than one item 
on most devices. 

RPT reports also flag more than one item if a device encounters an error or cannot perform an 
operation because of another error condition. This condition occurs when an abnormal device 
status condition causes an I/O function to fail. The RPT report flags both the I/O function 
failure and the abnormal device status. 

An error definition in the RPT report then compresses all the device-supplied information to a 
single item reflecting the most probable error reported by the device. 

1.1.4 CFL 

The error logging system includes a Control File Language (CFL) compiler that is used 
to recompile patched DIGITAL-written control file modules or user-written modifications or 
additions to modules. Chapters 4 and 5 describe the operation of the CFL compiler and the 
DIGITAL-supplied control file module for the RM02/RM03 disk drive. 

1.2 Error Logging Options 

Routines in the Executive respond to the following four types of errors: 

• Unexpected traps or interrupts 

• Device errors 

• Device timeouts 

• Memory errors 
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1.2.1 Unexpected Traps or Interrupts 

When your system includes error logging support, all unused system vectors are filled with 
pointers to routines in the Executive. Therefore, routines in the Executive are called if a trap or 
interrupt occurs to one of these unused vectors. For example, a noisy electrical environment or 
a static discharge may cause an unexpected trap or interrupt to one of the unused vectors, or a 
valid interrupt may be vectored to the wrong address. In these cases, the Executive records this 
information. 

1.2.2 Device Errors 

Device errors are problems that a device encounters while carrying out a software-requested 
operation. When a device error occurs and error logging is active, the device driver calls 
Executive routines to record the contents of the device registers or other hardware-supplied 
information. The registers indicate the state of the device and its controller. The routines also 
record information found in the actual I/O request to the driver, such as the type of operation 
attempted. This information can help you interpret the device error. 

1.2.3 Interrupt Timeouts 

Interrupt timeouts occur when the device that initiated an operation fails to complete the 
operation within the length of time the driver specified. When the transfer starts, software 
timers detect interrupt timeouts. The system records the same information for timeouts that it 
records for device errors. 

1.2.4 Memory Errors 

Memory errors occur when the parity bit stored with the data during a write operation does 
not match the parity calculated when the data is read. Some types of main memory use parity 
to ensure integrity of the information. All RSX-llM-PLUS systems (except the pregenerated 
systems and Micro/RSX) include support for logging memory parity errors. 
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Chapter 2 

Error Logger Task (ERRLOG) and Error Log Interface 
(ELI) 



This chapter describes how to use the Error Logger task (ERRLOG) and the Error Log Interface 
(ELI). Chapter 1 provided a general overview of how ERRLOG and ELI work, along with the 
Report Generator (RPT), to form the complete error logging system. 

ERRLOG gets event and status information from device drivers and the Executive in the form of 
error log packets and writes the packets in an error log file on disk. The Executive also performs 
error limiting to allow a maximum number of errors to be logged on each device before logging 
stops. 

ELI, the user interface to ERRLOG, includes sv«tches to perform the following operations: 

• Start or stop logging or limiting 

• Change device error limits or error counts 

• Establish or change log file names 

• Display information about the error logging status of any device or of the entire system 

ERRLOG is the only part of the error logging system that must be installed for error logging to 
occur. You can install ELI when you issue commands to ERRLOG and install RPT when you 
create reports. 

MCR and DCL Equivalents 

If your system supports DCL, you can use DCL error logging commands in place of most MCR 
ELI switches. Where ELI commands or their formats are listed in this chapter, the MCR form 
is listed first and the DCL equivalent is listed directly underneath. For example, the following 
format line shows an MCR ELI command, and then the DCL command that performs the same 
operation. 

Format 

[filespecl/LOG [/subswitchfes]] 
START/ERROR_LOG [/qualifier [s]] [filespec]) 
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2.1 Installing ERRLOG and ELI 

To install the ERRLOG task, enter the following command from a privileged terminal or as an 
entry in the system startup command file (both the MCR and DCL commands are shown): 

>INS $ERL \M} 

$ INSTALL $ERRLOG \M] 

To install ELI, enter the following command from a privileged terminal or as an entry in the 
system startup command file: 

>INS $ELI [Ml 

$ INSTALL $ELI [ML 

To invoke ELI after it is installed, issue the foUovwng MCR command from any terminal: 

>ELI \M] 

If ELI is not installed, you can invoke it from a privileged terminal using the following command: 

>RUN $ELI \M} 

$ RUN $ELI mil 

When ELI is invoked, your terminal will display the following prompt: 

ELI> 

2.2 Using ERRLOG and ELI 

You can use the ELI /SH switch to display error logging information from any terminal. 
However, you must use a privileged terminal to execute any other ELI commands. 

Enter each command on a separate line unless the command description specifies otherwise. 

The general MCR format of an ELI command is as follows: 

ELI>filespec [device: [: . . .]]/switch[/. . .] 

The general DCL format of an ELI command is as follows: 

$ command [/qualifier [a]] [device [s]] filespec 

Parameters 

filespec 

The name of an error log file or file to append to the current error log file. 

device 

A device mnemonic indicating the device for which you want to perform error logging. 

switches 

Switches to set, change, or display ERRLOG operation. (You must specify at least one 
switch on each ELI command line.) 
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If you want to start error logging and use only the ERRLOG defaults, enter the following ELI 
command: 

ELI>/LOG [M] 

$ START/ERR0R_LOG \Mi 

This command starts ERRLOG, using LB:[l,6]LOG.ERR as the default log file and 
LB:[1,6]BACKUP.ERR as the default backup file. Specify the /LOG switch to use ERRLOG 
defaults. 

The /LOG switch also starts error limiting to limit the number of hard and soft errors ERRLOG 
records on each device before it stops logging on that device. The default error limit, used 
when you begin limiting with the /LOG switch, is five hard errors and eight soft errors for each 
device. You can change these limits with the /HL or /SL switches described in Section 2.4.1. 
However, you cannot use the switches to change limits on the same command line as the /LOG 
switch. 

2.3 ELI Switches 

This section describes the following four types of ELI switches and subswitches: 

• Logging switches 

• Error limiting switches 

• File-naming switches 

• The display switch 

Remember that these switches only control operation of the Error Logger. Chapter 3 describes 
the RPT commands that generate actual error log reports. Chapter 5 describes the commands 
that control the Control File Language (CFL) compiler. 

Table 2-1 summarizes the ELI switches and subswitches and their equivalent DCL commands. 
ELI S5mtax requires that you specify at least two characters of a switch name and as many 
additional characters as it takes to make the switch unique. Refer to the ELI switch descriptions 
in this section for the exact syntax and use of each command. 
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Table 2-1: ELI Switches and Subswitches 



MCR 

ELI Switches 
and Arguments 



DCL Commands 
and Qualifiers 



Function 



/LOG 


START/ERROR_LOG 


/TY:arg[s] 


/INCLUDE=arg[s] 


ALL 


ALL 


C 


CONTROL 


E 


ERRORS 


M 


MEMORY 


PE 


PERIPHERAL 


PR 


PROCESSOR 


SY 


SYSTEM-INFORMATION 


/NV 


/NEW_VERSION 


/-LIM 


/NOLIMITING 


/UP[DATE] 


/UPDATE (Micro/RSX only) 


/ZE[RO] 


/ZERO (Micro/RSX only) 


/NOLOG 


STOP/ERROR_LOG 


/[-]LIM[IT] 


SET ERROR_LOG/[NO]LIMITING 


/HL 


SET ERROR LOG/HARD T IMIT 


/SL 


SET ERROR LOG/SOFT LIMIT 


/RE[SET] 


SET ERROR_LOG/RESET_COUNTS 


/AP[PEND] 


APPEND ERROR_LOG 


/DE[LETE] 


/DELETE 


/SW[ITCH] 


SET ERROR LOG/NEW I,OG_FILE 


/DE 


/DELETE 


/NV 


/NEW_VERSION 


/BA[CKUP] 




/SH[OW] 


SHOW ERROR-LOG 


filespec 


/OUTPUT 



Begins error logging operation 

Specifies type of error logging 

Includes all information in error log 
file 

Includes ELI control packets 

Includes peripheral, processor, and 
memory errors 

Includes errors in memory 

Includes information from peripherals 

Includes events in CPU 

Includes system information, not 
device-specific 

Creates a new file version 

Starts logging without error limiting 

Updates ERRORS.ACC file 

Clears ERRORS.ACC file 

Stops all error logging and limiting 

Starts or stops use of error limiting 

Sets limit for hard errors 

Sets limits for soft errors 

Resets QIO and error counts to 

Appends specified file to error log file 

Deletes specified file after appending 

Copies current file to new file 

Deletes old logging file 

Creates new version of logging file 

Sets name of backup file to next- 
highest version of named file 

Displays error logging on all devices 

Writes display to a file 
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Table 2-1 (Cont.): ELI Switches and Subswitches 



MCR 

ELI Switches DCL Commands 

and Arguments and Qualifiers 



Function 



/CU[RRENT] /CURRENT 



/HI[STORY] /HISTORY 



/NEW 



/RECENT 



Shows error counts since last tin\e 
/UPDATE was used (Micro/RSX 
only) 

Shows error counts from ERRORS 
.ACC (Micro/RSX only) 

Shows n\ost recent errors (Micro/RSX 
only) 



2.3.1 The Logging Switches 

ELI logging switches start or stop logging on all error logging devices in the system. (See 
Table 2-2, Error Logging Devices.) 

2.3.1.1 The /LOG Switch 
Format 

[filespec]/LOG [/subswitch[/ . . .]] 
START/ERROR.LOG [/qualifier!/...]] [filespec] 

The /LOG switch begins error logging operation and optionally allows you to specify a file in 
which the Error Logger writes the data it collects (see Section 2.4.2). If you specify an existing 
file, the /LOG switch appends new data to that file unless you also specify the New Version 
switch (/NV) in the command line. 

The /LOG switch also turns on error limiting by default, unless you specify the No Limiting 
(/-LIM) switch to override it. 

You can use the following subswitches with the /LOG switch: 

/-LIM[1T] 

/NOLIMITING 

The No Limiting (/-LIM) subswitch begins logging with no error limiting. This subswitch 
overrides the default ERRLOG operation in which /LOG automatically turns on error 
limiting. 

/NV 

/NEW_VERSION 

The New Version (/NV) subswitch causes the Error Logger to create a new version of 
the error log file (either the file you specify in the command line or the default error log 
file, LB:[l,6]LOG.ERR). This subswitch overrides the default operation in which the /LOG 
switch appends data to the current version of the error log file. 



Error logger Task (ERRLOG) and Error Log Interface (ELI) 2-5 



/TY[PE]:arg[,...] 
/INCLUDE=[arg[,...]] 

The /TYPE subswitch selects error log packets based on their packet type. The packets 
included in the report are determined by the following arguments: 

MCR Arguments DCL Arguments 

ALL ALL 

C[ONTROL] CONTROL 

E[RROR] ERRORS 

M[EMORY] MEMORY 

PE[RIPHERAL] PERIPHERAL 

PROCESSOR] PROCESSOR 

SY[STEM_INFO] SYSTEM_INF0RMAT10N 

The /TYPE subswitch arguments are described as follows: 

ALL 

Selects all error log command packets in the error log file. This is the default. 

CONTROL 

Selects error log command packets that control the Error Log Interface task (ELI). 

ERROR 

Selects error log packets from system peripherals, the processor, and memory. 

MEMORY 

Selects error log packets from events that occur in memory (such as memory parity errors). 

PERIPHERAL 

Selects error log packets from all peripheral devices that support error logging. This 

argument does not display system information (such as mounts and dismounts) for the 

devices. 

PROCESSOR 

Selects error log packets from events that occur in the CPU, such as unknown interrupts. 

SYSTEM_INFO 

Selects error log packets from events that occur on the system but are not specifically tied 
to errors on a single piece of hardware, such as time changes and system service messages, 
as well as some device-specific events such as mounts and dismounts. 

/UP[DATE] 

/UPDATE (Micro/RSX only) 

The /UPDATE subswitch updates the historical part of the file of accumulated errors 
(ERRORS.ACC) to reflect the latest information in ERRORS.LOG. It then creates a new 
version of ERRORS.LOG that contains no error events. You cannot use the /UPDATE 
subswitch on the same command line with the /ZERO subswitch. 
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/ZE[RO] 

/ZERO (Micro/RSX only) 

The /ZERO subswitch erases all the accumulated errors in ERRORS.ACC. It then creates a 
new version of ERRORS.LOG that contains no error events. You cannot use the /ZERO 
subswitch on the same command line with the /UPDATE subswitch. 

2.3.1.2 The /NOLOG Switch 
Format 

/NOLOG or /-LOG 

STOP/ERROR_LOG 

The /NOLOG switch stops error logging and error limiting on all devices. 

2.4 Error Logging Devices 

Table 2-2 lists the device modules included in the original version of the file 
LB:[l,6]ERRLOG.ULB, as distributed with the error logging system. However, if you have 
deleted any device modules from the universal library using the indirect command file described 
in Appendix A, your system will not include support for those devices. If you want error 
logging support for the devices listed in Table 2-2, include the control file module hsted with 
the device in the universal library. See Appendix A for information on how to include and 
delete modules from the universal library. 

Table 2-2: Error Logging Devices 



Device 



Control File Module 



MLll 


EMLll 


RA60 


MSCP60 




MSCPAT 




MSCPCE 




MSCPEN 




MSCPTO 


RA80 /RA81 


DEVUDA 




MSCP5X 




MSCPAT 




MSCPCE 




MSCPEN 


RC25 


MSCPSD 




MSCPAT 




MSCPCE 




MSCPEN 




MSCPTO 




DEVUDA 


RD50 /RD51 /RD52 


MSCPTO 


RD53 /RD54 


DEVUDA 
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Table 2-2 (Cont.): Error Logging Devices 



Device 



Control File Module 



RK03/RK05 ERK05 

RK06 /RK07 ERK67 

RLOl /RL02 ERL12 

RM02 /RM03 ERM23 

RM05 ERM05 

RM80 ERM80 

RP02 /RP03 ERP23 
RP04 /RP05 /RP06 ERP456 

RP07 ERP07 

RSll ERSll 

RS03 /RS04 ERS34 

RXOl ERXOl 

RX33 /RX50 MSCP5X 

TAll ETAll 

TCll ETCH 

TK50 ETK50 
TS03 /TEIO /TTIO ET0310 

TSll /TU80 ETSll 

TSV05 ETSV05 
TU16 /TE16 /TU45 ET1645 

TU58 ETU58 

TU60 ETU60 

TU77 ETU77 

TU81E ETU81 



2.4. 1 The Error Limiting Switches 

The limiting switches control the error limiting operation of ERRLOG. You can use them to 
start or stop error limiting or to change error limits on specific devices. When a device reaches 
the user-specified error limit or the default error limit, ERRLOG displays the following warning 
message on the console terminal or on any terminal that has allocated or attached the device: 



ERRLOG 



♦♦WARNING: Device dd: Exceeded (xxxx) Limit (n) 
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In the warning message, xxxx is the type of limit (hard or soft) and n is the number to which 
the limit is set. 

When the device reaches an error limit, error logging for that type of error stops on the device 
until you reset the error and QIO counts to or raise the error limit. 

You can reset the error and QIO counts to with the ELI /RESET switch. Mounting or 
dismounting the device or rebooting the system also resets the error and QIO counts to 0. 
However, using the /-LOG switch to stop logging does not reset the error and QIO counts. 

Logging on a device stops only when the device reaches both of the limits set for hard and soft 
errors. If, for example, the device reaches its limits for hard errors but not for soft errors, it will 
continue to log soft errors until the soft error limit is also reached. 

2.4.1.1 The /LIMIT Switch 
Format 

/[-]LIM[IT] or /[NDlLIM 
SET ERROR_LOG/ [NO] LIMITING 

The /LIMIT and No Limit (/-LIM) switches start and stop the use of error limits, respectively. 
These limits are set by default for all devices on the system when you enable error logging or 
they are set for individual devices with the hard and soft limit switches described below. The 
/LIM switch does not activate error logging if it is not currently active on the system. 

When you specify the /LOG switch to begin error logging, it automatically starts error limiting 
on all error logging devices unless you inhibit limiting with the /-LIM switch. 

The /-LIM switch inhibits the incrementing of hard and soft error counts, which are displayed 
by the ELI /SH switch and in the RMD T page. 

Note 

If you start error logging with no limiting and the error counts happen to be at 
zero when error logging is started, ELI displays the counts as zeros even though 
errors continue to be logged. To check the number of errors that occur when 
limiting is off, you must use RPT to generate an error report. 

2.4.1.2 The Hard Limit Switch 
Format 

ddim:[ ] /HL : n [/SL : n] 

SET ERROR_LOG/HARD_LIMIT:n[/S0FT_LIMIT:n] ddim: [. . . .] 

The Hard Limit (/HL) switch sets limits for the number of hard errors that error logging records 
on the device specified. Hard errors occur on a device when an I/O operation fails and cannot 
be recovered by the device driver. You can set hard error limits for more than one device in 
the same command line, as long as the limits are the same. The default hard error limit on 
each device is five. 

The value for n can be to 255. If you set the limit to 255, logging continues without stopping 
(the limit is infinite). If the limit is set to 0, no errors will be logged. 
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You can use the Soft Limit (/SL) switch on the same command line with the /HL switch, 
thereby controlUng both hard and soft device error limits on the same command line. You can 
specify different limits for hard and soft errors. 

2.4.1.3 The Soft Limit Switchi 
Format 

ddim:[,...]/SL:n[/HL:n] 

SET ERROR_LOG/SOFT_LIMIT:n[/HARD_LIMIT:n] ddnn: [ ] 

The Soft Limit (/SL) switch sets limits for soft errors. Soft errors occur on a device when an 
I/O operation fails, but succeeds in a subsequent retry attempt. You can set soft error limits for 
more than one device in the same command line, as long as the limit is the same. The default 
soft error limit for each device is eight. 

The value for n can be to 255. If you set the limit to 255, logging continues without stopping 
(the limit is infinite). If the limit is set to 0, no errors will be logged. 

You can use the Hard Limit (/HL) subswitch on the same command line with the /SL switch, 
thereby controlling both hard and soft device error limits on the same command line. You can 
specify different limits for hard and soft errors. 

2.4.1.4 The /RESET Switch 
Format 

ddnn:[ ]/RE[SET] 

SET ERROR.LOG/RESET.COUNTS ddnn: [ ] 

The /RESET switch resets the QIO count and error count for the specified devices to 0. You 
can specify up to 14 devices in one command line. You cannot reset QIO and error counts on 
all devices in the system at once by specifying the /RE switch without specifying devices. 

When ERRLOG resets the counts to 0, it displays the following message on the console terminal: 

ERRLOG - - Error and QIO counts reset for ddnn: 

2.4.2 The File-Naming Switches 

The file-naming switches establish and change the names of error log files. 

2.4.2.1 The /LOG Switch 
Format 

[filespec]/LOG 
START/ERROR_LOG [filespec] 

The /LOG switch, which also initializes the Error Logger, sets the name of the error log file 
that the Error Logger uses. If you specify an existing error log file, the default operation is 
to append data to the current version of that file. To override the default, specify the New 
Version (/NV) subswitch. The Error Logger then creates and writes data in a new version of 
the file. The /LOG switch does not work when error logging is already active on your system. 
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The default error log file specification is LB:[1,6]L0G.ERR. The /LOG switch also specifies 
LB:[1,6]BACKUP.ERR as the backup file. 

2.4.2.2 The /APPEND Switch 
Format 

filespec/APCPEND] [/D[ELETE]] 
APPEND/ERROR_LDG [/DELETE] filespec 

The /APPEND switch appends the specified file to the end of the current log file. Error logging 
must be active for this switch to work. 

The default operation is to append the specified file to the current error log file and to keep the 
appended file. 

You can use the following subswitch with the /APPEND switch: 

/DE[LETE] 
/DELETE 

The /DELETE subswitch causes the Error Logger to delete the specified file after it is copied 

to the end of the current error log file. 

2.4.2.3 The /SWITCH Switch 
Format 

filespec /SW[ITCH] [/subswitch] 

SET ERROR.LOG /NEW_LOG_FILE : filespec [/qualilier] 

The /SWITCH switch copies the current error log file to the file you specify and begins logging 
in that file. The default operation appends data to an existing version of the file and preserves 
the old version of the error log file. 

You can use the following ELI subswitches or DCL qualifiers on the command line with the 
/SWITCH switch: 

/NV 

/NEW_VERSION 

The New Version (/NV) subswitch creates a new version of the file you specify. This 
subswitch overrides the default operation in which the /SW switch appends data to the 
latest version of the file. 

/DE[LETE] 
/DELETE 

The /DELETE subswitch causes the Error Logger to delete the current error log file after it 

copies the file to the new file you specify. 



Error Logger Task (ERRLOG) and Error Log Interface (ELI) 2-11 



2.4.2.4 The /BACKUP Switch 
Format 

filespec /BA[CKUP] 

The /BACKUP switch spedfies the file to be used as a backup file if the Error Logger cannot 
write to the current log file. By default, the backup file is LB:[1,6]BACKUP.ERR. 

The backup file specification is kept, but no file is created until needed. You may wish to have 
your backup file on a different device from the current log file. By default, both files are on 
pseudo device LB:. 

When the Error Logger cannot write to the current log file, it creates and opens the backup file 
and writes to it. At that point, you no longer have a backup file, and the Error Logger displays 
the following message on the console terminal: 

ERRLOG - - Log file error - logging continuing on backup file 

After error logging switches to the backup file, there is no longer a backup file available. 

The Error Logger uses the specified backup file as the current error log file. It does not rename 
the file to LOG.ERR, even though the file is now the error log file. 

At this point, you should specify a new backup file, using the /BACKUP switch. Otherwise, if 
the Error Logger cannot write to the new log file, it will not be able to continue by writing in 
a backup file. 

If the Error Logger tries to switch logging to a nonexistent backup file, it displays the following 
message: 

ERRLOG - - Backup file error - logging discontinued 

When that happens, logging stops and must be restarted. 

If you create the backup file on a disk other than the disk containing the error log file, this 
ensures that logging will continue even if the disk with the error log file develops problems. 

2.4.3 The /SHOW Switch 
Format 

[f ile8pec=] [ddnn : [ ] ] /SH [OW] [/subswitch] 

SHOW ERROR_LOG [/qualifier [/...]] [ddnn : [ ] ] 

The Display (/SHOW) switch provides a brief display of error logging information on the 
devices specified (up to 14). The default is to display this report on your terminal. If the 
command does not specify devices, the Error Logger displays information on all error logging 
devices in the system by default. 

The display shows the total number of errors that have occurred since error logging was started 
in the current ERRORS.LOG file. The display includes only errors from devices that are on line. 
It does not show the time or order in which the errors occurred. 
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The /SHOW switch uses the following arguments and subswitches: 

filespec 

/OUTPUT[:(llespec] 

The filespec argument allows you to specify that the output from the /SHOW switch be 
written in a file instead of displayed on your terminal. In DCL, if you use the /OUTPUT 
qualifier without a file specification, the system uses the file name ERRORS.LST. If you 
specify a file name, the system uses that name. 

/C[URRENT](Micro/RSX only) 

/CURRENT 

The /CURRENT subswitch displays the error counts that have occurred on all devices since 
error logging was started using the /LOG/UPDATE switch. The /CURRENT subswitch 
displays the current section of the ERRORS.ACC file. 

/H[ISTORY](Micro/RSX only) 

/HISTORY 

The /HISTORY subswitch displays the error counts from the historical part of the file 
ERRORS.ACC. This includes hard and soft errors from the last time the file was set to zero 
through the last time the file was updated. Errors that occurred after the file was updated 
are not included in the historical display, but rather in the current display. To see them, 
use the /CURRENT subswitch. 

/N[EW](Micro/RSX only) 

/RECENT 

The /NEW subswitch displays the information in the ERRORS.LOG file to show only the 
most recent errors. It also shows the time and order in which they occurred. This display 
automatically includes all error logging devices. 

Example 2-1 illustrates the output from the operation of the /SH switch. 
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Example 2-1: Error Logging Status 

Error Logging Status 12-AUG-87 00:51:54 
Logging: On Limiting: On 

Log File: LB: [1.6] LOG -ERR File ID: DR3: 32,252 
Backup File: LB: [1.6] BACKUP. ERR 



Device Hard Error 


Soft Error 


QIO 


Name Count/Limit 


Count/Limit 


Count 


MMO 


0./5. 


0./8. 


23. 


MMl 


075. 


0./8. 


9776. 


MM2 


0./5. 


0./8. 


0. 


MM3 


: 0./5. 


0./8. 


0. 


DBO 


: 0./5. 


0./8. 


14144. 


DBl 


0./5. 


0./8. 


0. 


DB2 


0./5. 


* 8./8. 


46528. 


DRO 


0./5. 


0./8. 


0. 


DRl 


0./5. 


0./8. 


0. 


DR2 


0./5. 


0./8. 


164234. 


DR3 


0./5. 


0./8. 


625364. 


DS: 


0./5. 


0./8. 


130. 


DSl 


O./O. 


O./O. 


0. (Offline) 


DKO 


0./5. 


0./8. 


1. 


DKl 


0./5. 


0./8. 


0. 


DM0 


0./5. 


0./8. 


0. 


DM1 


0./5. 


0./8. 


0. 


DLO 


0./5. 


0./8. 


0. 


DLl 


0./5. 


0./8. 


0. 


DTO 


0./5. 


0./8. 


0. 


DTI 


0./5. 


0./8. 


0. 


DT2 


0./5. 


0./8. 


0. 


DT3 


0./5. 






DYO 


0./5. 


0./8. 


1. 


DYl 


0./5. 


0./8. 


1. 


DDO 


0./5. 


0./8. 


0. 


DDl 


0./5. 


0./8. 


0. 



If you specify device names with the /SHOW switch, the output is the same as shown in 
Example 2-1, except that the display only includes information on the devices you specified. 

The asterisk next to the soft error limit for DB2 indicates that DB2 reached the soft error limit 
and logging of soft errors stopped. Note that the logging of hard errors will continue on DB2 
until the hard error limit is reached. 

The display continues to record additional QIOs on the device, even after logging stops, because 
the Executive maintains the QIO count. Therefore, the ratio of errors to QIOs on the device 
does not necessarily give you an accurate statistical error percentage. 
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2.5 ERRLOG and ELI Messages 

ERRLOG displays messages on the console terminal when errors occur during an operation. 
In some cases, ERRLOG displays messages on any terminal that has allocated or attached the 
device on which the error occurs. ELI displays messages on the terminal that invoked it. This 
section describes the messages, their causes, and possible user responses. 

2.5. 1 ELI Messages 

ELI— ERRLOG not installed 

Explanation: ERRLOG is not installed on the system. 

User Action: Install ERRLOG from a privileged terminal and issue the ELI command again. 

ELI — Failed to communicate with ERRLOG 

Explanation: ELI could not communicate with ERRLOG using the Executive directive SMSG$. 
User Action: Fatal error. No user action is possible. 

ELI — File name must be specified 

Explanation: You used a /BACKUP, /APPEND, or /SWITCH switch without specifying a 
file name. 

User Action: Reenter the ELI command with an appropriate file specification. 

ELI — Get Command Line error 

Explanation: The Get Command Line procedure failed. 

User Action: This may be a temporary condition. Retry the operation. 

ELI — Illegal switch combination 

Explanation: You used an ELI swritch in combination with subswritches other than those 
allowed on a command string with that switch. (See Table 2-1.) 

User Action: Reenter the command string, specifying a valid combination of switches on 
each string. Use a separate command string for additional switches, if necessary. 

ELI — Maximum number of devices exceeded 

Explanation: You attempted to reset QIO and error counts on more than 14 devices in one 
command string. 

User Action: Specify the /RESET switch again, with 14 or fewer devices. 

ELI — Switch requires device name ddnn: only 

Explanation: You specified both a device name and a UFD and/or a file name with an ELI 
switch that accepts only a device name. 

User Action: Reenter the command line, specifying only a device name. 
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ELI — Syntax error 

Explanation: You used an invalid switch or file specification or made some other syntactical 
error. 

User Action: Reenter the command line, using the proper command string syntax. 

2.5.2 ERRLOG Messages 

ERRLOG — Backup file error - logging discontinued 

Explanation: ERRLOG encountered an error when it wrote in the log file. It then tried to 
write in the backup file, but could not. This error occurs if you fail to establish a new 
backup file after ERRLOG switches logging to the backup file. 

User Action: Issue an ELI /BACKUP command to establish a new backup file and restart 
logging. 

ERRLOG — Device not In system 

Explanation: ERRLOG tried to use a device that is not in the system configuration. 

User Action: Check to be sure you specified the correct device and reenter the command. If 
the device is correct, no user action is possible, 

ERRLOG — Error and QIO counts reset for ddnn: 

Explanation: The error and QIO counts for a given device were reset. 
User Action: No user action is necessary. This is an informational message. 

ERRLOG — Error log packet too long 

Explanation: ERRLOG encountered an error log packet that was too large. The error log 
packet was corrupt. 

User Action: If the error logging system includes user-generated error log packets, check 
the code to make sure none of the packets are too long. Otherwise, submit a Software 
Performance Report (SPR). 

ERRLOG — Failed fo assign LUN 

Explanation: ERRLOG tried to assign a logical unit number (LUN) to a terminal to send a 
notification message and the assignment failed. This occurs when a device exceeds the error 
limit set for it and ERRLOG tries to notify the terminal or task that has the device allocated 
or attached. 

User Action: No user action is necessary. The error limiting operation succeeded. This 
informational message tells you ERRLOG was unable to notify the allocating terminal. 
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ERRLOG— File I/O error 

Explanation: ERRLOG tried to execute an ELI /SWITCH or /APPEND command and could 
not open the new file or copy the old file to the new one. When this error occurs, logging 
continues in the original log file. 

User Action: No action is required to continue logging. Retry the ELI /SWITCH or 
/APPEND command. 

ERRLOG — Log file error - logging continued on bacl<up file 

Explanation: An error occurred when ERRLOG tried to write in the error log file. The 
logging operation transferred to writing in the backup file. The backup file becomes the log 
file, but retains the given name. 

User Action: Issue an ELI command to establish a new backup file. Otherwise, if ERRLOG 
gets an error when it writes in the new file (the previous backup file), it will not find a 
backup file to use. 

ERRLOG — Logging already active 

Explanation: ERRLOG received an ELI command to begin logging when logging was already 
running. 

User Action: No user action is necessary to continue logging. 

ERRLOG — Logging initialized 

Explanation: ERRLOG displays this message on the console terminal when ELI starts 
ERRLOG operation using the /LOG switch. 

User Action: No user action is necessary. This is an informational message. 

ERRLOG — Logging not active 

Explanation: The ERRLOG task is not currently running on your system. 

User Action: Issue an ELI /LOG command from a privileged terminal and retry the operation. 

ERRLOG — Logging stopped 

Explanation: When ELI stops ERRLOG operation, using the /-LOG switch, ERRLOG displays 
this message on the console terminal. 

User Action: No user action is necessary. This is an informational message. 

ERRLOG — No data subpacket 

Explanation: ERRLOG tried to use a corrupted data subpacket. 

User Action: If the error logging system includes a user-written control file module to 
generate error log packets, check the code. Otherwise, submit an SPR. 
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ERRLOG — No device subpacket 

Explanation: ERRLOG tried to use a corrupted device subpacket. 

User Action: If the error logging system includes a user-written control file module to 
generate error log packets, check the code. Otherwise, submit an SPR. 

ERRLOG — Privilege violation 

Explanation: You tried to issue a privileged ELI command (to set or change ERRLOG 
operations) from a nonprivileged terminal. Nonprivileged users can only issue ELI /SHOW 
commands. 

User Action: Log in to a privileged terminal and issue the commands. 

ERRLOG — Task subpacket corrupted 

Explanation: ERRLOG tried to use a corrupted task subpacket. 
User Action: Submit an SPR. 

ERRLOG — Unable to open file 

Explanation: ERRLOG could not open the log file to begin logging. ERRLOG then transfers 
logging to the backup file immediately. 

User Action: Issue an ELI command to establish a new backup file. 

ERRLOG — Unknown command packet subtype 

Explanation: ERRLOG encountered an unknown command packet subtype. 

User Action: If the error logging system includes a user-written control file module to 
generate error log packets, check the code. Otherwise, submit an SPR. 

ERRLOG WARNING: Device ddnn: exceeded xx Limit (x) 

Explanation: Device ddnn exceeded the error limit set with an ELI Hard Limit (/HL) or Soft 
Limit (/SL) switch or the default error limit of five hard errors and eight soft errors. 

User Action: Check to see if the number of errors indicates a serious hardware malfunction. 
To continue logging on the device, reset the QIO and error counts to zero with the /RESET 
switch or change the limits using the /HL or /SL switch. 
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Chapter 3 

Report Generator Task (RPT) 



This chapter describes how to use the Report Generator task (RPT) to create error log reports. 

Chapter 1 provided ar\ overview of the interaction of elements in the error logging system (the 
error log control file and the Control File Language (CFL) compiler). The RPT switches described 
in this chapter use modules from the error log control file to determine how to interpret and 
format information from the error log file. (See Chapter 2 for a description of how the Error 
Logger creates the error log file.) RPT and modules in the error log control file work together 
to interpret the information in the error log file and define an event that occurs on a device. 
They do not analyze the event itself or attempt to diagnose hardware failures. 

All RPT reports use the same entry number to refer to the same error log packet, so you can 
use RPT brief reports to isolate a device or specific events occurring on that device, and then 
specify entry numbers to generate a full report on only the specific events you want to look 
at in more detail. Note, however, that some ELI commands may change the packet number 
associated with an event. For example, appending a file to the error log file will change the 
packet numbers in the appended file. 

MCR and DCL Equivalents 

If your system supports DCL, you can use DCL ANALYZE/ERROR_LOG commands instead 
of MCR RPT switches. Where RPT commands or their formats are listed in this chapter, the 
MCR form is listed first and the DCL equivalent is listed directly underneath. For example, 
the following format line shows an MCR RPT command, and then the DCL command that 
performs the same operation: 

Format 

/DA[TE] : argument 
ANALYZE/ERROR.LOG/qualifier 
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3.1 Installing and Running RPT 

Since RPT is a nonprivileged task, anyone can use it to create error log reports when it is 
installed on the system. To install RPT, enter the following MCR or DCL command from a 
privileged terminal or as an entry in the system startup command file: 

>INS $RPT [m 

$ INSTALL $RPT [M] 

To invoke RPT after it is installed, issue the following MCR command from any terminal: 

>RPT [rH] 

If RPT is not installed, you can invoke it from any terminal, using the following MCR or DCL 

command: 

>RUN $RPT Ml 

$ RUN $RPT M] 

When RPT is invoked, your terminal will display the following prompt: 

RPT> 

3.2 Using RPT to Create Error Log Reports 

The error log control file needs at least three types of information from RPT switches to generate 
error log reports, as follows: 

• How to select which error log packets to analyze 

• How to format the error log packets 

• How to summarize the information from the error log packets 

Switches on the RPT command line provide this information, which is independent of the file 
specification they accompany. 

3.2.1 The RPT Command Line 

This section describes the general MCR RPT command line format and the general DCL 
ANALYZE/ERROR—LOG command line format. Note that the default parameters of the MCR 
RPT command line and the DCL ANALYZE/ERROR_LOG command line are different. This 
does not prevent DCL users from duplicating any MCR command, but you should be aware 
that the following MCR and DCL command formats are not exactly equivalent. 

The MCR RPT Command Line 

The only element you must specify in an MCR RPT command Hne is the equal sign ( = ). All 
other file and switch specifications in the command line are optional. 

The general MCR format of an RPT command line is as follows: 

RPT> [reportlile] [/switch [/. . . ] ] = [inputf ile] [/switch!/. . .]] 
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reportfile 

The name of the listing file that contains the error log report. If you do not specify the 
reportfile parameter, RPT sends the file by default to ERRREPORT.LST in your current 
directory. 

Instead of a report file, you can specify Tl: to send the report to your terminal. On systems 
with transparent spooling, you can specify LP: to send the report to the line printer. 

switch(es) 

Optional switches to control how RPT selects, formats, and summarizes information from 
the error log file. You can use the same switches with either the report file specification 
or the input file specification on the command line. For example, if your command line 
specifies "input file/WIDE," RPT will apply the wide format to the output file. In this case, 
the format width cannot apply to the input file. RPT uses the switches in the order you 
specify, but ignores which file specification they accompany. 

input file 

The only input file you can specify in the command line is the error log file, the disk file 
that the Error Logger creates in LB:[l,6]LOG.ERR. 

RPT also uses a universal library of compiled control file modules as input. RPT looks 
first for the file LX:[l,6]ERRLOG.ULB. If it does not find it, RPT looks for the file 
LB:[l,6]ERRLOG.ULB. (Use pseudo device LX if you v^ish to save space on LB.) RPT 
includes this file by default and you cannot specify or change it from the command line, so 
it is not part of the format described previously. 

RPT can, however, prompt for the name of a universal library. If you want RPT to prompt 
you for the universal library name, you must edit the RPTBLD.BLD file and make the value 
of USERCM nonzero, then relink RPT. If you do make this alteration, note that it has the 
additional effect of preventing you from issuing an RPT command line from the MCR level. 
Instead, invoke RPT as follows: 

>RPT 

CTL>univer8al library filespec 

RPT>coiiinand line 

The MCR RPT input and output files assume the defaults listed in Section 3.2.2, unless you 
specify otherwise in the command line. 

The DCL ANALYZE/ERROR_LOG Command Line 

The general DCL format of an RPT command line is as follows: 

$ ANALYZE/ERROR_LOG [/OUTPUT [: reportfile]] [/qualifier [s]] [inputfile] 

The default parameters are similar to those of the general MCR RPT command line, except for 
the reportfile parameter. 

In DCL, you use the /OUTPUT qualifier to specify the report file. If you do not specify the 
/OUTPUT qualifier, the RPT report is displayed on your terminal in narrow format and no 
output file is created. If you use the /OUTPUT qualifier with no report file name specified, RPT 
creates a report in a file called ERRREPORT.LST. By default, the /OUTPUT qualifier creates a 
file in wide format. 
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3.2.2 Using the Default MCR RPT Command Line 

To use the default RPT command line, enter the following MCR-level command: 

RPT>= [RfT] 

The equal sign (=) causes RPT to use the file specification defaults and switch defaults listed in 
this section. This command creates a brief format report without any summaries, using all of 
the error log packets in the error log file. The file specification defaults are listed in Table 3-1. 

Table 3- 1 : RPT File Specification Defaults 

Universal 
Parameter Report File Input File Library File^ 



Device 


SYO 


LB 


LX,LB 


UIC 


Current UIC 


[1,6] 


[1,6] 


File name 


ERRREPORT 


LOG 


ERRLOG 


File type 


LST 


ERR 


ULB 


Version 


New 


Latest 


Latest 



Not specified by the user 



The default RPT command line invokes the following switches: 

/FORMATiBRIEF 

Creates a brief format report that contains one line for each error log packet described in 
the report. (See Section 3.3.2.) 

/TYPE:ALL 

Creates a report on packets describing all types of events: peripheral, processor, memory, 
control, and system information packets. (See Section 3.3.1.5.) 

/DATE:RANGE:-:- 

Creates a report on packets of all dates. (See Section 3.3.1.1.) 

/DEVICE:ALL 

Creates a report on all error logging devices in the system. (See Section 3.3.1.2.) 

/PACKET:-:- 

Creates a report for all packet numbers. (See Section 3.3.1.3.) 

/SUMMARY:NONE 

Does not create summary reports of statistical information on packets included in the report. 

/WIDTH:WIDE 

Creates a vvdde (132-column) report. 
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3.2.3 Using Multiple Arguments in RPT Command Lines 

You can specify each RPT switch only once in a command line. However, some switches 
provide an alternative syntax that allows you to specify more than one argument for the switch, 
as follows: 

/switch: (arg.argC, . . .]) 
AHALYZE/ERROR.LOG/qualifier: (arg.arg[ ]) 

The parentheses, which are a required part of the command syntax, allow RPT to use more 
than one argument for the switch. If you do not specify the parentheses, RPT displays the 
following message on your terminal and exits: 

ERLCNF-F-SYNTAXERR command line syntax error 

As an example, to specify a report on more than one device, use the following RPT switch: 

/DE:(DB,DM2:,DR) 

ANALYZE/ERROR_LOG/DEVICES: (DB,DM2: ,DR) 

RPT generates a report on all the DB and DR devices in your system, as well as device DM2. 
The switches that permit you to specify multiple arguments in this way are the following: 

• The /DEVICE switch 

• The /PACKET switch 

• The /SERIAL switch (one drive and one pack serial number) 

• The /TYPE switch 

• The /SUMMARY switch 

3.3 RPT Report Switches 

This section describes the RPT switches according to the RPT requirement that they fulfill. 
These switches tell RPT how to perform the following tasks: 

• Selecting packets 

• Formatting packets 

• Summarizing information from packets 

RPT syntax requires only that you specify enough characters of a command or qualifier to make 
it unique. For example, you can specify /T for the MCR /TYPE switch, but you must specify 
/SU for the /SUMMARY switch to distinguish it from the /SERIAL switch. 

The command line examples used throughout this chapter highlight the command they describe. 
Any switches not explained in the command descriptions assume the default values described 
in Section 3.2.2. 
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Table 3-2 summarizes the RPT report switches in alphabetical order. 



Table 3-2: RPT Report Switches and Arguments 



MCR 

RPT Switches 

and Arguments 



DCL 

ANALYZE/ERROR-JLOG 
Qualifiers and Arguments 



Function 



reportfile parameter /OUTPUT 



/DA[TE]: 
P:n 



/PREVIOUS_DAYS:r\ 



R 




/SINCE:date/THROUGH:date 


T 




/TODAY 


Y 




/YESTERDAY 


/DE[VICE]: 




/DEVICES: 


device name(s) 


device name(s) 


ALL 




ALL 


/F[ORMAT]: 






B 




/BRIEF 


F 




/FULL 


N 




/NODETAIL 


R 




/REGISTERS 


/P[ACKET]: 




/ENTRY: 


start[:end] 




start[:end] 


*:* 




ALL 


/R[EPORT]: 




/COMMAND: 


D 




DAY 



Specifies the output file for the RPT 
report 

Selects packet based on date 

Specifies packets from previous n 
days 

Specifies starting and ending dates 

Specifies packets created on current 
day 

Specifies packets created yesterday 

Selects packets based on device 

Specifies devices 

Selects all devices on the system 

Describes how RPT formats the error 
log packets 

Displays each packet on one line 

Displays all of the information in the 
specified packet 

Does not display information packet- 
by-packet 

Displays the same information as 
the /FULL qualifier, but shows only 
the device registers on packets for 
peripheral errors 

Selects packets based on packet num- 
ber 

Selects one or a range of packets 

Selects all packets 

Invokes a predefined string of switches 

Displays full format reports based on 
current day's packets 
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Table 3-2 (Cont.): RPT Report Switches and Arguments 



MCR 

RPT Switches 

and Arguments 



DCL 

ANALYZE/ERROR_LOG 
Qualifiers and Arguments 



Function 



W 



WEEK 



Displays summary reports sorted by 
device error history based on previ- 
ous seven days' packets 



M 


MONTH 


Displays summary reports sorted by 
device error history based on previ- 
ous 31 days' packets 


SY 


SYSTEM 


Displays summary reports sorted by 
device error history for all packets in 
the system 


user string 


user string 


Invokes a user-defined switch string 


/SE[RIAL]: 


/SERIAL -NUMBER: 


Select packet based on serial number 


D:n 


DRIVE:n 


Selects packet based on drive serial 
number 


P:n 


PACK;n 


Selects packet based on pack serial 
number 


D:n:P:n 


DRIVE:n,PACK:n 


Selects packets based on both drive 
and pack serial numbers 


/SU[MMARY]: 


/STATISTICS: 


Selects the type of summary report 


A 


ALL 


Selects all summary reports 


E 


ERROR * 


Creates a report based only on device 
errors 


G 


DISK-GEOMETRY 


Creates a report based on disk geom- 
etry 


H 


HISTORY 


Creates a report based on device error 

history 


N 


NONE 


Creates no summary report 


/T[YPE]: 


/INCLUDE: 


Selects packets based on packet type 


A 


ALL 


Selects all packets in the error log file 


C 


CONTROL 


Selects command packets from ELI 


E 


ERRORS 


Selects packets from processor, mem- 
ory, and peripherals 


M 


MEMORY 


Selects packets from events in mem- 



ory 
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Table 3-2 (Cont.): RPT Report Switches and Arguments 



MCR 


DCL 






RPT Switches 
and Arguments 


ANALYZE/ERROR TOG 
Qualifiers and Arguments 


Function 


PE 


PERIPHERAL 




Selects packets from all peripheral 
devices 


PR 


PROCESSOR 




Selects packets from events in CPU 


S 


SYSTEM INFORMATION 


Selects from system events, not 








hardware-specific 


/V[OLUME] 


/VOLUME-LABEL 




Selects packets for peripheral errors 
based on the volume label 


/W[IDTH]: 


[NOJWIDE 




Selects the width of RPT report 


N 






80 columns (ignored on summary 
reports) 


W 






132 columns 



3.3. 1 Packet Selection Switcties 

The following switches tell RPT how to select which error log packets to report on. (This 
selection is based on an attribute of the device or the packet or on the date and time that the 
packet was created.) 

3.3.1.1 The /DATE Switch 
Format 

/DA [TE] : argument 
ANALYZE/ERROR.LOG/qualifier 

The /DATE switch allows you to select packets based on the date that an event occurred. This 
switch allows arguments to specify a range of dates or to specify a particular day. You can 
also use the /DATE switch with another switch, the /REPORT switch, to create reports for the 
previous week or month (see Section 3.3.4). 

You can use the following arguments with the /DATE switch: 



MCR Arguments 

P[REVIOUS]:n days 

R[ANGE]:start_date:end_date 

T[ODAY] 

Y[ESTERDAY] 



DCL Qualifiers 

/PREVIOUS_DAYS:n 

/SINCE:start_date/THROUGH:end_date 

/TODAY 

/YESTERDAY 
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The /DATE switch arguments are described as follows: 

PREVIOUS 

Allows you to specify packets from the previous n days. 

RANGE 

Accepts starting and ending dates in the following standard RSX formats: 

DD-MMM-YY 
(DD-MMM-YY HH:MM:SS) 

If you specify the second format, with time as well as date, the parentheses are a required 
part of the syntax. 

When you use the starting date and ending date format, the starting date rounds off to a 
time of 00:00:00 and the ending date rounds off to 23:59:59. 

The asterisk (*) used at the beginning of a range specification indicates any date through 
the specified ending date. For example, *:12-AUG-87 specifies all of the packets from the 
beginning of the error log file through August 12, 1987. 

The asterisk used at the end of a range specification indicates any date since the specified 
beginning date. For example, 4-FEB-87:* specifies all of the packets from 00:00:00 on 
February 4, 1987, through the end of the error log file. 

TODAY 

Creates reports on error log packets created during the current day; that is, since midnight. 

YESTERDAY 

Generates reports on packets created during the previous day. 

When you use the default RPT command line (see Section 3.2.2), RPT invokes the /DATE 
switch as foUows: 

/DATE:RANGE:*:* 

3.3.1.2 The /DEVICE Switch 
Format 

/DE[VICE] : device [s]=inputfile 
ANALYZE/ERROR_LOG/DEVICES : device [s] [inputf ile] 

The /DEVICE switch allows you to select packets for a particular device, for more than one 
device, or for all the devices on the system. You can specify more than one device with the 
/DEVICE switch by using the special syntax described in Section 3.2.3. 

MCR Arguments DCL Arguments 

device_list device_list 

ALL ALL 

The default argument is ALL. 
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RPT uses the following conventions for device names with the /DEVICE switch: 

Mnemonic Meaning 

dd Selects all devices with the mnemonic dd 

ddnn: Selects the device with the mnemonic dd and the unit number nn 

For example, /DE:DM selects all DM devices, and /DE:(DM,DB2:) selects all DM devices and 
device DB2. 

When you use the default RPT command line (see Section 3.2.2), RPT invokes the /DEVICE 
switch as follows: 

/DEVICE: ALL 

3.3.1.3 The /PACKET Switch 
Format 

/P [ACKET] : packet .number [s] 
ANALYZE/ERRQR_LOG/ENTRY : packet .number [s] 

The /PACKET svdtch allows you to select a packet or range of packets by specifying the packet 
identification numbers. You can determine the packet numbers you want to see by examining 
a brief report of all packets. 

To select just one packet, you specify one packet number. For example, /PA:123.4 selects only 
packet number 123.4. To select a range of packets, you specify the first and last packet numbers 
of that range. For example, /PA:123.4:432.1 selects all the packets from packet 123.4 through 
packet 432.1. 

MCR Arguments DCL Arguments 

mmm.mmm[:nnn.nnn] mmm.mmm[:nnn.nnn] 

*:* ALL 

You can specify more than one packet or packet range by using the special syntax described in 
Section 3.2.3. 

The asterisk (*) indicates an open-ended number. You can select all the packets before a 
particular number (*:235.3), or all the packets after a particular number (235.3:*). 

When you use the default RPT command line (see Section 3.2.2), RPT invokes the /PACKET 
switch as follows: 

/PACKET:*:* 
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3.3.1.4 The /SERIAL Switch 
Format 

/SE[RIAL] : argument 
ANALYZE/ERROR_LOG/SERIAL_MUMBER : argument 

The /SERIAL switch allows you to select packets based on their drive or pack serial number 
or both. This switch only applies to peripheral errors. You can select packets from any device 
that has a serial number by drive serial number, but you can only select packets from MSCP 
and last-track devices by pack serial number. Appendix B explains where RPT gets drive serial 
numbers and lists the significant digits in serial numbers for each error logging device. 

The arguments for the /SERIAL switch allow you to specify one drive or one pack serial 
number, or both, in the same command line. 

You can use the following arguments with the /SERIAL switch, where n is the drive or pack 
serial number: 

MCR Arguments DCL Arguments 

D[RIVE]:n DRIVE:n 

P[ACK]:n PACK:n 

D[RIVE]:n,P[ACK]:n DRIVE:n,PACK:n 

3.3.1.6 The /TYPE Switch 
Format 

/T [YPE] : argument 
ANALYZE/ERROR_LOG/ INCLUDE : argument 

The /TYPE switch selects error log packets based on their packet type. Use one or more of the 
following arguments with the /TYPE switch: 

MCR Arguments DCL Arguments 

A[LL] ALL 

C[ONTROL] CONTROL 

E[RRORS] ERRORS 

M[EMORY] MEMORY 

PERIPHERAL] PERIPHERAL 

PR[OCESSOR] PROCESSOR 
S[YSTEM_INFORMATION] SYSTEM -INFORMATION 

The /TYPE switch arguments are described as follows: 

ALL 

Selects all error log packets in the error log file. 

CONTROL 

Selects error log command packets that control the Error Log Interface task (ELI). 

ERRORS 

Includes information on all peripheral, processor, and memory errors in the error log file. 
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MEMORY 

Includes information from all events that occur in memory, such as memory parity errors. 

PERIPHERAL 

Includes information from all peripheral devices in the system that support error logging. 
This argument does not include logging of system information, such as mounts and 
dismounts, for the devices. (Use the SYSTEM—INFORMATION argument to display that 
information.) 

PROCESSOR 

Includes information from events that occur in the CPU itself, such as unknown interrupts. 

SYSTEM_INFORMATION 

Includes information from events that occur on the system, but are not specifically tied 
to a single piece of hardware. For example, if you use the SYSTEM —INFORMATION 
argument, error logging includes information on time changes, system service messages, 
and device-specific events (such as mounts and dismounts). 

You can specify more than one t3^e of packet by using the special syntax for the /TYPE switch, 
described in Section 3.2.3. However, note that the ALL argument and the ERRORS argument 
cannot be used with other arguments, but must be specified alone. 

When you use the default RPT command line (see Section 3.2.2), RPT invokes the /TYPE 
switch as follows: 

/TYPE: ALL 

3.3.1.6 The /VOLUME Switch 
Format 

/V[OLUME] :Tolume_label 
ANALYZE/ERROR_LOG/VOLUME_LABEL : volume.label 

The /VOLUME switch selects packets based on the specified volume label, as illustrated in the 
following example: 

RPT>^/T:PE/V:ERRLOGSYS \M] 

This command line specifies that RPT find the device or devices that contain a volume with the 
label ERRLOGSYS, and generate a report of peripheral errors on those devices. Since the /TYPE 
switch specification did not include system information, the report will not include mounts or 
dismounts for the devices. 
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3.3.2 The /FORMAT Switch 
Format 

/F[ORMAT] : argument 
ANALYZE/ERROR_LOG/qualifier 

The /FORMAT switch tells RPT how to format a report from packets in the error log file. You 
can select reports in brief format (one line for each error), in full format (all the information 
from the error log packets specified), or in register format (dumping only the registers for device 
errors). 

Note that there is no single DCL command equivalent to the MCR /FORMAT switch. Instead, 
DCL uses qualifiers to the ANALYZE/ERROR_LOG command. 

MCR Arguments DCL Qualifiers 

B[RIEF] /BRIEF 

F[ULL] /FULL 

REGISTER] /REGISTERS 

N[ONE] /NODETAIL 

The following sections describe the /FORMAT arguments in detail. 

3.3.2. 1 Brief Reports 

Brief reports are short, one-line-per-packet reports on selected packets. 

The brief report shov*T:i in Example 3-1 displays one line of information about each of the 
error log packets specified in the RPT command line. The annotated list following the example 
describes the sections in the brief report. The numbers in the list correspond to the numbers of 
the sections in Example 3-1 . 

The following RPT command line generated the brief report in Example 3-1: 

RPT>EXMBRIEF1 . RPTsRAISIN . LOG/PA : (2 . 1 . 5 . 1 , 5 . 2 . 6 . 4 , 10 . 3 . 42 . 2) 
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O The error log packet Entry Number, which describes the relative position in the error log file. 
This number does not change unless the file is changed; for example, by an ELI/ APPEND 
command. It is not changed by normal logging into the file. 

® The date and time the packet was logged. 

® The type of entry in the error log file; for example, hard or soft device errors or system 
information. 

O The device on which the error occurred. 

The error type as defined by the hardware information. RPT does not do any interpretation 
of these errors; it merely reports the hardware information. 

© Any other information error logging gathers on the error, such as the I/O function that 
occurred at the time of the error. 

O The RPT command line that generated the report. 

© Input and report file specifications. 

® The format selection. 

® The packet time-range selection (the time the packets were created). 

© The volume label selection. 

© The drive and pack serial number selections. 

® The types of summary reports selected. 

© The packet type selections. 

© The packet number selections. 

© The device selections. 

© The number of packets printed and processed. 

© The time RPT report generation began and ended. 

3.3.2.2 Full Reports 

Full reports provide a detailed listing of device events. They list and interpret all of the 
information collected in the error log packets they specify. 

The full report shown in Example 3-2 displays the complete contents of error log packet number 
2.1, a header-not-found error described in the brief report in Example 3-1. The annotated list 
following the example describes the sections of the full report. The numbers on the list 
correspond to the numbered sections in Example 3-2. 

The following RPT command line generated the full report in Example 3-2: 

RPT>EXEMPF . RPT=RAISIN . LOG/PA : 2 . 1/F : F [Ml 
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O The same identification information listed in items 1 through 5 of the brief report description. 

@ System identification information including operating system and base level, CPU type, and 
address mapping type. 

@ Device identification information including the device name, device type, volume label, 
controller, unit number, pack and drive serial numbers, total I/O count on the device, 
the amount of data transferred in decimal words, the number of cylinders crossed wrhile 
accessing data, and the number of hard and soft errors logged previous to this device. 

O I/O operation identification includes the terminal and UIC that initiated the operation, the 
task name, the beginning physical memory address of the I/O buffer, the length of the 
1/0 request (in bytes), the maximum number of retries the device driver allows for an I/O 
operation, the number of retries remaining, and the actual I/O operation taking place. 

© Concurrent I/O activity occurring on other devices when this error occurred. This section is 
present only when concurrent I/O activity takes place; otherwise, the section is suppressed. 

© I/O operation information includes the device I/O function and type of error as defined by 
the hardware. 

O The device error position information locates the error by cylinder, group, head, sector, and 
logical block number. 

© The device-supplied information includes a dump of the device registers according to name, 
contents, and interpretation of the bits in the registers. The asterisk ( * ) beside some bit 
interpretations means that the condition is likely to have contributed to the error. It is a 
sign that you may want to examine the condition. 

3.3.2.3 Register Reports 

Register reports contain the same information as full reports for all events except those that 
occur on peripherals. Register reports list the contents of all device registers for peripherals, but 
contain no other information. 

The register report in Example 3-3 includes only the register section of the full report (see 
Example 3-2) for packet 2.1 (the header-not-found error). 

The following RPT command line generated the register report shown in Example 3-3: 
RPT>EXEMPN . RPT=RAISIN . LOG/F : R/PA : 2 . 1 \M] 

3.3.2.4 No Report 

RPT does not generate a formatted output report on event information. The NONE argument 
causes RPT not to format the packets or produce a packet-by-packet report. The NONE 
argument is useful when you want to generate only a summary report. 

When you use the default RPT command line (see Section 3.2.2), RPT invokes the /FORMAT 
switch as follows: 

/FORMAT: BRIEF 
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3.3.3 The /SUMMARY Switch 
Format 

/SU[MMARY] : argument [s] 
ANALYZE/ERROR.LOG/STATISTICS : argument [s] 

The /SUMMARY switch tells RPT how to summarize the information from packets in the error 
log file. Since the summaries are compilations of the data gathered from the individual packets, 
the /SUMMARY switch tells RPT what particular piece of information from the packets to use 
as the basis for a summary report. 

RPT cannot create summary reports in narrow width. If you specify narrow width by using 
the /W:N switch, RPT formats the packet-by-packet display in narrow format, but formats the 
summary in wide format. 

You can use the following arguments with the /SUMMARY switch to generate summary reports: 

MCR Arguments DCL Arguments 

ALL ALL 

ERROR ERROR 

GEOMETRY DISK_GEOMETRY 

HISTORY HISTORY 

NONE NONE 

To generate more than one summary report from the same command line, use the special syntax 
described in Section 3.2.3. For example, the following command produces an ERROR report 
and a GEOMETRY report: 

RPT>=/SU: (ERROR, GEOMETRY) 

Note, however, that the ALL and NONE arguments may not be specified with other arguments. 

The /SUMMARY switch arguments are described in the following sections. 

3.3.3.1 The ALL Argunnent 

RPT generates summary reports sorted by error, geometry, and history. These summary reports 
are described in Sections 3.3.3.2 through 3.3.3.4. 

3.3.3.2 The ERROR Argument 

RPT generates a summary report sorted by error type. The ERROR summary, sorted by device, 
shows the number of times each error occurred on the device. The Count column of the 
summary tells the number of times the error occurred. Example 3-4 shows the summary section 
of an ERROR summary report. 

The following RPT command generated the report in Example 3-4: 
>RPT ERR0RRPT.LOG=/SU:E/F:N \M} 



When you specify /FORMAT:NONE, RPT does not display packets on a packet-by-packet basis 
as shown in the previous examples. 
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3.3.3.3 The GEOMETRY Argument 

RPT generates a summary report based on device geometry (logical block or sector, for example). 
The error count column of the summary tells how many times an error occurred in that device 
location. 

The following RPT command generated the report in Example 3-5: 

>RPT ERR0RRPT.LOG=/SU:G/F:N HHl 

3.3.3.4 The HISTORY Argument 

RPT generates a summary report sorted by device error history. It displays the hard and soft 
error count and QIO count for every volume used on each device. 

The following RPT command line generated the report in Example 3-6: 

>.RPT ERRORRPT.LOG=/SU:H/F:N [M] 

3.3.3.5 The NONE Argument 

The NONE argument is invoked when you use the RPT default command line. It causes RPT 
to generate no summary report. RPT invokes this argument to satisfy the requirement that the 
command line specify how to summarize the information from error log packets. 

3.3.4 The /REPORT Switch 
Format 

/REEPORT] : def ined_report_8tring 
ANALYZE/ERR0R_L0G/C0MMAND=defined_report_8tring 

The /REPORT switch invokes a predefined string of switches for RPT to use. The switch string 
usually defines a particular type of report, such as a report for a particular time period. The 
string contains any valid combination of RPT switches. The string cannot include the /REPORT 
switch. 

The /REPORT switch allows you to access a file that contains the switch combinations you use 
frequently and lets you invoke the switches by using the string name, instead of reentering the 
switches explicitly. 

RPT uses the normal default values described in Section 3.2.1 for all switches not defined in 
the switch string, if the svdtches have defaults. 

The DIGITAL and user-defined svritch strings are found in a control file module, PARSEM, 
or in a disk file, LB:[1,6]ERRDEFINE.CFS, respectively. The /REPORT switch first searches 
PARSEM, where it finds DIGITAL-defined strings. If the string is not defined there, RPT 
searches ERRDEFINE.CFS. 

Since RPT looks in the control file module first, you cannot redefine the DIGITAL-supplied 
strings unless you alter the control file module. DIGITAL does not recommend that you alter 
control file modules. You can change the definitions for DIGITAL-supplied strings by slightly 
altering their names and inserting the switch under the new name in ERRDEFINE.CFS. 
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3.3.4.1 Predefined Switch Strings 

DIGITAL supplies the following four predefined switch strings to use with the /REPORT switch: 

Predefined 

Switch String Switches Defined 

DAY /FO:FULL/SU:ALL/DA:TODAY 

WEEK /SU:(HISTORY,ERROR)/DA:PREVIOUS:7 

MONTH /SU:(HISTORY,ERROR)/DA:PREVIOUS:31 

SYSTEM /SU:(HISTORY,ERROR) 

Note that the names of the predefined switch strings must be entered in full. They cannot be 
abbreviated. 

3.3.4.2 User-Defined Switch Strings 

You can name and define your own switch strings to use with the /REPORT switch by creating 
and editing LB:[1,6]ERRDEFINE.CFS and inserting the switch strings you want to define. 

Entries in this file must be in the following form: 

'switchname' , 'swltchstrlng' 

switchname 

The name of the switch string you are defining. This name becomes the argument to the 
/REPORT switch when you want to invoke the string. (The name must be nine or fewer 
characters in length.) 

switchstring 

The RPT switches you select to generate the report. (The switch string must be 80 or fewer 
characters in length.) 

Note 

The single quotation marks are a required part of the syntax. You also must 
enter the full switch string name when you invoke a user-defined string. 

For example, if you want to generate a brief report of peripheral errors on all the DB devices 
on your system, edit ERRDEFINE.CFS and insert the following line: 

•DB','/FO:B/TY:PE/DE:DB' 

You can then create this report with the following RPT command: 

RPT>outfile=infile/R:DB IHl] 
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3.3.5 The /WIDTH Switch 
Format 

/W[IDTH] : argument 
ANALYZE/ERROR.LOG/qualifier 

The /WIDTH switch allows you to set the line width of the report RPT generates to narrow (80 
columns) or wide (132 columns). The basic report format does not change when RPT creates a 
narrow report. Instead, each long line of the report wraps onto the next line at an appropriate 
place. 

Summary reports do not honor the /WIDTH switch. The summary portion of these reports is 
always in the wide format. 

Note that there is no DCL command equivalent to the MCR /WIDTH switch. Instead, DCL 
uses qualifiers to the ANALYZE/ERROR_LOG command. 

You can use the following arguments with the /WIDTH switch: 

MCR Arguments DCL Qualifiers 

N[ARROW] /NOWIDE 

W[IDE] /WIDE 

When you use the default RPT command line (see Section 3.2.2), RPT invokes the /WIDTH 
switch as follows: 

/WIDTH: WIDE 

3.4 ERLCNF Report Messages 

The error log control file displays messages on your terminal if errors occur during report 
generation. The messages include an abbreviation, a severity level code for the error (warning, 
informational, or fatal), and text describing the error. 

In some cases, RPT also writes the message in the error log report, if it explains an error that 
appears in the report. For example, when RPT fails to find a control file module for a device 
you specify, it displays a message on your terminal and in the report that includes the error 
message. 

The following sections list the ERLCNF messages, along with possible causes and methods for 
recovery. 

3.4. 1 ERLCNF Fatal Errors 

ERLCNF-F-ARGNOTUNQ, Argument specification <argument> is not unique 

Explanation: You did not specify enough characters in a switch argument to make it unique. 
It will be confused with another argument. 

User Action: Check the argument syntax and reenter the command. 
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ERLCNF-W-BADSUBPKT, Possible corruption in flie <paci<etname> subpacitet in item 

<item label > 

Explanation: RPT found something in the subpacket that appeared to be abnormal. The file 
may be corrupted or it may be an internal error within RPT. 

User Action: You should never see this message. If you do, send in a Software Performance 
Report (SPR) along with a dump of the packet that generated the message and any other 
information you have. You can create a dump of the packet using the starting virtual block 
number of the packet (the nnn portion of the packet number nnn.m). 

If the message refers to a packet that you have altered or a module that you wrote, correct 
the module, recompile, and add it to the library. 

ERLCNF-W-DUILLFORM, MSCP format code <code> is undefined 

Explanation: This may be an internal error vdthin RPT. It indicates a format code in the 
RA80 packet that is corrupted. 

User Action: You should never see this message. If you do, send in an SPR along with a 
dump of the packet that generated the message and any other information you have. (See 
the BADSUBPKT description.) 

ERLCNF-F-ILLARGCOIVI, Illegal argument combination 

Explanation: You specified an illegal combination of arguments with a switch. 
User Action: Check the syntax and reenter the command. 

ERLCNF-F-ILLFILSPC, Illegal file specification - <filename> 

Explanation: You used an illegal file specification with an RPT report-generating command. 
User Action: Check the syntax and try the operation again. 

ERLCNF-W-ILLPACCOD, illegal code In packet <packetld> , Code = <xx> 

Explanation: The major code for the indicated packet is beyond the range that RPT can 
handle. 

User Action: You should never see this message. If you do, send in an SPR along with a 
dump of the packet that generated the message and any other information you have. (See 
the BADSUBPKT description.) 

If the message refers to a packet that you have altered or a module that you wrote, correct 
the module, recompile, and add it to the library. 

ERLCNF-F-ILLPACRAN, illegal packet range - LOW = <xx> , HIGH = <xx> 

Explanation: The RPT Packet Selection (/PACKET) switch requires arguments to be packet 
numbers in a specific format. 

User Action: Determine the correct number for the packet you want to display, check the 
syntax, and reenter the command. 
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ERLCNF-W-ILLPACSBC, Illegal subcode in packet <packetld> , Code = <xx> , Subcode = 
<xx> 

Explanation: The subcode for the indicated packet is beyond the range that RPT can handle. 

User Action: You should never see this message. If you do, send in an SPR along with a 
dump of the packet that generated the message and any other information you have. (See 
the BADSUBPKT description.) 

If the message refers to a packet that you have altered or a module that you wrote, correct 
the module, recompile, and add it to the library. 

ERLCNF-F-ILLPACSPC, Illegal packet specification <pocketld> 

Explanation: You used an invalid packet specification with an RPT report-generating 
command. 

User Action: Resubmit the command file with the correct packet specification. 

ERLCNF-F-ILLSWTARG, Illegal switch argument - <argument> 

Explanation: RPT recognized the switch argument, but determined that the argument is 
incorrect in the context given. 

User Action: Check the syntax and reenter the command. 
ERLCNF-F-INTERROOl, Internal error detected at position number <n> 

Explanation: This is an internal RPT error. It occurs with the PARSECLST and PARSECTION 
error messages. 

User Action: You should never see this message. If you do, send in an SPR and the 
command line that generated the message and any other information you have. 

ERLCNF-F-MODNOTFND, Module not found - <module> 

Explanation: RPT searched ERRLOG.ULB for the module and did not find it. 

User Action: You should never see this message. If you do, send in an SPR and the 
command line that generated the message. Be sure to include the name of the module that 
was missing. 

ERLCNF-F-MULARGSPC, Argument <argument> specified multiple times 
Explanation: You specified an RPT switch argument more than once. 
User Action: Check the syntax and reenter the command. 

ERLCNF-F-MULSWTSPC, Switch <switch> speclHed multiple times 

Explanation: You entered the specified switch more than once on the same RPT command 
line. RPT allows you to specify each switch only once. 

User Action: Check the syntax and reenter the command. Use the special syntax for multiple 
switch specifications described in Section 3.2.3, if the switch allows it. 
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ERLCNF-F-NODIDPACK, No DEVICE-ID subpacket 

Explanation: This is an internal error within RPT. 

User Action: You should never see this message. If you do, send in an SPR along with a 
dump of the packet that generated the message and any other information you have. 

ERLCNF-W-NODRIVSZ, No drive of size <size> for mnemonic <cidnn> ; using EUNKWN 

Explanation: This may be an internal error within RPT. 

User Action: You should never see this message if you have only DIGITAL hardware. If you 
have non-DIGITAL hardware and you receive this message, it is caused by a disagreement 
between RPT's table of device sizes and the actual size of the device. See Section 4.4.2 for 
information on changing the table of device sizes. 

ERLCNF-W-NODRIVTYP, No drive type <type> for mnemonic <dd> using EUNKWN 

Explanation: This may be an internal error within RPT. From the mnemonic, the drive 
appears to be a MASSBUS device. However, RPT does not recognize the device type as a 
MASSBUS device. 

User Action: You should never see this message if you have only DIGITAL hardware. If 
you have non-DIGITAL hardware, the error is caused by a disagreement between RPT's 
table of device sizes and the size of the actual device. See Section 4.4.2 for information on 
changing the table of device sizes. 

ERLCNF-F-NOINPFILE, No input flie specified 

Explanation: RPT did not find an input file on the command line. This message occurs 
when you fail to specify an equal sign ( = ) in the command. 

Lfser Action: Check the syntax and reenter the command. 
ERLCNF-W-NONOTES, No notes available for device <devlcename> 

Explanation: RPT includes a facility for displaying notes at the bottom of Full or Register 
reports. This internal error message indicates that a device did not have an associated 
NOTES module. 

User Action: You should never see this message. If you do, send in an SPR along with a 
dump of the packet that generated the message and any other information you have. (See 
the BADSUBPKT description.) 

If the message refers to a packet that you have altered or a module that you wrote, correct 
the module, recompile, and add it to the library. 

ERLCNF-F-NOREMATCH, No predefined switch string for <strlng> 

Explanation: RPT did not find the defined report string you used in a /REPORT command, 
either in ERRDEFINE.CFS or among the DIGITAL-defined report strings. Remember to use 
the entire name of the DIGITAL or user-defined string. 

User Action: Check the syntax and reenter the command. 
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ERLCNF-F-OPNINPFIL, Failed to open the input file 

Explanation: RPT could not open the input file specified. This message is accompanied by 
the FILERRCOD information message, which displays the PCS error code from the file. 

User Action: Check the PCS error code and retry the command after correcting the indicated 
condition. 

ERLCNF-F-OPNREPFIL, Failed to open the report file 

Explanation: RPT could not open the report (output) file specified. This message is 
accompanied by the FILERRCOD information message, which displays the PCS error code 
from the report file. 

User Action: Check the PCS error code and retry the command after correcting the indicated 
condition. 

ERLCNF-F-OPNUSRFIL. Failed to open the user file 

Explanation: RPT could not open the user file specified. This message is accompanied by 
the PILERRCOD information message, which displays the PCS error code from the file. 

User Action: Check the PCS error code and retry the command after correcting the indicated 
condition. 

ERLCNF-F-SWTNOTUNQ, Switch specification <switcti> is not unique 

Explanation: You did not specify enough characters of a switch to make it unique. It will 
be confused with another switch. 

User Action: Check the switch syntax and reenter the command. 
ERLCNF-F-SYNTAXERR, Command line syntax error 

Explanation: Some element of the command line does not have the correct syntax. 
User Action: Check the syntax and reenter the command. 

ERLCNF-F-TOOFEWARG, Too few arguments in switch <$witciiname> 

Explanation: You specified a switch that requires one or more arguments without specifying 
enough arguments. 

User Action: Check the syntax and reenter the command. 
ERLCNF-F-UNKNWARG, Unl<nown argument - <argument> 

Explanation: You specified an argument that is unknown to RPT. 
User Action: Check the syntax and reenter the command. 
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ERLCNF-W-UNKNWNDEV, Device mnemonic <cld> is unl<nown; using EUNKWN 

Explanation: This may be an internal error within RPT. 

User Action: You should never see this message. If you do, send in an SPR along with a 
dump of the packet that generated the message and any other information you have. (See 
the BADSUBPKT description.) 

If the message refers to a packet that you have altered or a module that you wrote, correct 
the module, recompile, and add it to the library. 

ERLCNF-W-UNKNWNNOT, No note number <number> for device <devicename> 

Explanation: RPT includes a facility for displaying notes at the bottom of reports. This 
internal error message indicates that a device tried to print a note that was not available. 

User Action: You should never see this message. If you do, send in an SPR along with a 
dump of the packet that generated the message and any other information you have. (See 
the BADSUBPKT description.) 

If the message refers to a packet that you have altered or a module that you wrote, correct 
the module, recompile, and add it to the library. 

ERLCNF-F-UNKNWSWT, Unknown sv/itch - <switclnname> 
Explanation: You specified an unknown RPT switch. 
User Action: Check the syntax and reenter the command. 

3.4.2 ERLCNF Warning Message 

ERLCNF-W-USEEUNKWN, IVIodule <modulename> not found; using EUNKWN 

Explanation: RPT was not able to find the module specified in the error logging universal 
library and went to the EUNKWN module instead. This causes a formatted dump of the 
device register to appear in the report. This message usually occurs if you tune your 
universal library and eliminate the module for a device you want to use. 

User Action: Retune the universal library to include the missing module. 

3.4.3 ERLCNF Informational Messages 

These messages accompany other ERLCNF messages to give you additional information. They 
do not affect RPT operation. 

ERLCNF-I-FILERRCOD, File error code = <errorcode> 

Explanation: This message displays the PCS error code for a file. It accompanies messages 
on file-access failures. 

User Action: None is necessary. This is an informational message. 
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ERLCNF-I-PARSECLST, PARSE.SECTION_LIST = <buf> 

Explanation: This is an internal error within RPT. This message accompanies the INTERROOl 
message described previously. 

User Action: You should never see this message. If you do, send in an SPR along with a 
dump of the packet that generated the message and any other information you have. (See 
the BADSUBPKT description.) 

If the message refers to a packet that you have altered or a module that you wrote, correct 
the module, recompile, and add it to the library. 

ERLCNF-I-PARSECTION, PARSE.SECTION = <buf> 

Explanation: This is an internal error within RPT. It accompanies the INTERROOl message 
described previously. 

User Action: You should never see this message. If you do, send in an SPR along with a 
dump of the packet that generated the message and any other information you have. (See 
the BADSUBPKT description.) 

If the message refers to a packet that you have altered or a module that you wrote, correct 
the module, recompile, and add it to the library. 

3.5 ERLRPT Report Messages 

Most of the following error messages are either associated with errors in the control file module 
that RPT is interpreting or are internal RPT errors. 

If the message refers to a control file module that you have altered or a module that you wrote 
and added to the error logging system, correct the error, recompile the module, and add it to 
the library. The module in which the error occurred is specified in the first (or top) line of the 
execution stack dun\p produced by RPT. This information appears on the report file and on the 
terminal from which RPT is being run. 

If the message refers to a DIGITAL-suppIied module or is an internal RPT error, please submit 
a Software Performance Report (SPR) and include a listing of the error log report file produced 
by RPT. 

ERLRPT-F-ACCUDFVAR, Attempt to access undefined variable. 

Explanation: A control file module attempted to access a variable that had not been defined. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-BADDIGIT. Invalid numeric digit In conversion. 

Explanation: A numeric literal or the ASCII string argument for the %COD$OCTAL, 
%COD$DECIMAL, %COD$HEX, %COD$BCD, %COD$BINARY, or %COD$MACHINE 
function contained an invalid character for the specified radix or was null or blank. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 
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ERLRPT-F-BITFLDSIZ, Bit or field too lorge in extraction operation. 

Explanation: The bit or field in an extraction operation exceeded the size of the value on 
which the extraction was performed. 

User Action: Correct the user-written module or submit an SPR for DIGITAL -supplied 
modules. 

ERLRPT-F-BiTTOOHIG, Bit number too large for specified storage unit. 

Explanation: The bit number specified by the character string portion of a #BI, #WI, #LI, 
#QI, or #VI numeric literal was too large for the specified value size. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-CASENOIVIAT, CASE selection expression has no matclning value. 

Explanation: No match was found for the value of the selector expression in a CASE 
statement, and no ELSE clause was specified in the CASE statement. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-CONTROLFI, Could not open control file. 

Explanation: The control file module could not be opened. 

User Action: If you are using the default control file library, check to see that it is in either 
LX:[1,6] or LB:[1,6] and is not locked, and that you have read access to it. If you are using a 
user-specified control file, check to see that it is not locked and that you have read access. 

ERLRPT-F-COROUIVIIS, COROUTINE statement executed with no COROUTINE stack frartie. 

Explanation: A COROUTINE statement was executed without specifying a coroutine in the 
corresponding CALL statement. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-CRASH, Control file requested abort. 

Explanation: The CRASH statement was executed by a control file module. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-DATNOTEXI, Data declaration is longer than data. 

Explanation: The amount of data specified in a PACKET or SUBPACKET declaration was 
larger than the amount of data in the packet or subpacket. This condition may be due to 
an error in the control file module or an error in the error log packet being analyzed. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 
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ERLRPT-F-DECAGAIN, Group in declaration already declared. Redeclaration illegal. 

Explanation: A DECLARE, PACKET, SUBPACKET, TABLE, or DYNAMIC-TABLE statement 
was executed with a group name that was already defined. 

User Action: Correct the user-written module or submit an SPR for DlGITAL-supplied 
modules. 

ERLRPT-F-DECGRPCTX, Group In DECODE statement has no context. 

Explanation: The group in the DECODE statement was a TABLE, DYNAMIC-TABLE, or 
PACKET or SUBPACKET with the REPEATED attribute for which the current record context 
was not valid. 

User Action: Correct the user-written module or submit an SPR for DlGITAL-supplied 
modules. 

ERLRPT-F-DECNOBIT, No BIT declaration corresponding to DECODE list item. 

Explanation: The bit number specified for a data item in the DECODE statement had no 
corresponding BIT declaration for the data item in the specified group. 

User Action: Correct the user-written module or subnut an SPR for DlGITAL-supplied 
modules. 

ERLRPT-F-DECNOTEXT, No bit to text translation for DECODE list item. 

Explanation: The BIT declaration corresponding to the bit number specified for a data item 
in the DECODE statement had no print expression. 

User Action: Correct the user-written module or submit an SPR for DlGITAL-supplied 
modules. 

ERLRPT-F-DEFCASELS, No match for control expression in CASE conditional definition. 

Explanation: No match was found for the value of the selector expression in a CASE 
conditional definition and no ELSE clause was specified. 

User Action: Correct the user-written module or submit an SPR for DlGITAL-supplied 
modules. 

ERLRPT-F-DEFNOCONT, Attempt to access data in variable in group with null context. 

Explanation: The control file module attempted to access a variable in a TABLE, DYNAMIC- 
TABLE, or PACKET or SUBPACKET with the REPEATED attribute for which the current 
record context was not valid. 

User Action: Correct the user-written module or submit an SPR for DlGITAL-supplied 
modules. 

ERLRPT-F-DEFNOSTAK, Declaration stacl< overflow. 

Explanation: The stack used for processing declarations has overflowed. 

User Action: Edit RPTBLD.CMD to increase the extension for program section DCSTKO, and 
rebuild RPT. 
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ERLRPT-F-DEFSTKUND, Internal error - Declaration stack underflow. 

Explanation: This is an internal error within RPT. 

User Action: Please submit an SPR with any information you have. 

ERLRPT-F-DIVZERO, Attempt to divide by zero. 

Explanation: A control file module attempted to divide by zero. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-EXEINVCOD, Internal error - Execution stack entry has invalid code. 

Explanation: This is an internal error within RPT. 

User Action: Please submit an SPR with any information you have. 

ERLRPT-F-EXEINVPOS, Internal error - Input file has invalid position value. 
Explanation: This is an internal error within RPT. 
User Action: Please submit an SPR with any information you have. 

ERLRPT-F-EXPGRPNOC, Attempt to reference POINTER for group without context. 

Explanation: A control file module attempted to reference the POINTER special variable for 
a TABLE, DYNAMIC-TABLE, or PACKET or SUBPACKET with the REPEATED attribute 
for which the current record context was not valid. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-EXPINVCOD, Internal error - Invalid expression item code in expression. 
Explanation: This is an internal error within RPT. 
User Action: Please submit an SPR with any information you have. 

ERLRPT-F-EXPINVTYP, Internal error - Invalid symbol data type in expression. 
Explanation: This is an internal error within RPT. 
User Action: Please submit an SPR with any information you have. 

ERLRPT-F-EXPNORSYIVI, Symbol without read access referenced in expression. 

Explanation: A control file module attempted to read a variable defined in a DECLARE 
statement that had not been initialized. 

User Action: Correct the user- written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-EXPUDFGRP, Undefined group referenced in expression. 

Explanation: A control file module attempted to reference a group that had not been defined. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 
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ERLRPT-F-EXPUDFSYM, Undefined symbol referenced in expression evaluation. 

Explanation: A control file module attempted to access an undefined symbol. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-EXPVALOVR, Value stack overflow during expression evaluation. 

Explanation: The stack used for processing values and expressions has overflowed. 

User Action: Edit RPTBLD.CMD to increase the extension for program section VLSTKO, and 
rebuild RPT. 

ERLRPT-F-EXPVARNOC, Attempt to access variable without context In expression. 

Explanation: A control file module attempted to reference a variable in a TABLE, DYNAMIC- 
TABLE, or PACKET or SUBPACKET with the REPEATED attribute for which the current 
record context was not valid. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-FILERCLOS, File close error. 

Explanation: An error occurred when RPT attempted to close a file. 

User Action: Check for file access conflicts, device errors, or low pool condition. 
ERLRPT-F-FILERREAD, File read error. 

Explanation: An error occurred when RPT attempted to read a file. 

User Action: Check for file access conflicts, device errors, or low pool condition. 
ERLRPT-F-FILERSPAN, Records in file are not allowed to span blocks. 

Explanation: The span block attribute of the error log file being analyzed was set. ELI creates 
the error log file with this attribute set, and neither ELI, ERRLOG, nor RPT will modify it, 
but some other task may have. 

User Action: Use ELI to start or restart error logging with a new version of the error log 
file, then use the Peripheral Interchange Program (PIP) to append the previous version to 
the new version. PIP may produce the following warning message: 

PIP — Input files have conflicting attributes 

This message can be ignored. 

ERLRPT-F-FILERWRIT, File write error. 

Explanation: An error occurred when RPT attempted to write to a file. 

User Action: Check for file access conflicts, device errors, or low pool condition. 
ERLRPT-F-FILINTOPN, Internal error - File already open. 

Explanation: This is an internal error within RPT. 

User Action: Please submit an SPR with any information you have. 
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ERLRPT-F-FIUNVCOD, Internal error - Invalid file code for specified operation. 
Explanation: This is an internal error within RPT. 
User Action: Please submit an SPR with any information you have. 

ERLRPT-F-FILINVMOD, Control tile library has Invalid module name table format. 

Explanation: The control file library has an invalid module name table format. The control 
file must be a universal library. 

User Action: Ensure that the control file is a valid universal library and rerun RPT. 
ERLRPT-F-FILNOTCTX, Operation requires that dynamic file tiave context. 

Explanation: A control file module executed a POINTER DELETE or POINTER MOVE 
statement on a DYNAMIC—TABLE for which the current record context was not valid. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-FILNOTEXI, Internal error - Declared dynamic tile does not exist. 

Explanation: This is an internal error within RPT. 

User Action: Please submit an SPR with any information you have. 
ERLRPT-F-FILNOTVIR, Could not create virtual address space for module table. 

Explanation: RPT could not dynamically extend its address space to create room for the 
module table. 

User Action: If the maximum task size for the partition is less than 32K words, use the 
MCR command SET /MAXEXT or DCL command SET SYSTEM/EXTENSION -LIMIT to 
increase the maximum task size, or run RPT in a different partition. 

ERLRPT-F-FiLTOOBIG, File too large to read. 

Explanation: RPT cannot analyze error log files that are larger than 65,535io blocks. 

User Action: Use ELI to create new error log files more often. 

ERLRPT-F-FINDFiELD, FIELD in FIND statement does not have valid data type. 

Explanation: A control file module executed a FIND statement where the specified FIELD 
was not NUMERIC, STRING, ASCII, RSXTIME, VMSTIME, or LOGICAL. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-FINDNOCON, FIND statement not valid on a group with no context. 

Explanation: A control file module executed a FIND statement for a TABLE or DYNAMIC- 
TABLE attribute for which the current record context was not valid. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 
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ERLRPT-F-FORCLSNUL, FORMAT clause null. 

Explanation: A control file module executed a WRITE or WRITE —GROUP statement with a 
null FORMAT clause. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-FORFIELDS, FORMAT error - Field too narrow for variable to print. 

Explanation: A control file module executed a WRITE —GROUP statement where the width 
specified by a !DP directive was too short for the corresponding variable. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-FORFIELDW, FORMAT error - Name too long for field in IDF directive. 

Explanation: A control file module executed a WRITE —GROUP statement where the width 
specified in a IDF directive was less than the length of the name of the corresponding 
variable. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-FORINVCHA, FORMAT error - Invalid Character in FORMAT clause. 

Explanation: A control file module executed a WRITE or WRITE —GROUP statement with a 
FORMAT clause that contains a nonprinting character. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-FORINVCHR, FORMAT error - Invalid character in string in IDP directive. 

Explanation: A control file module executed a WRITE or WRITE— GROUP statement with a 
IDP directive that contains an invalid character. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-FORINVDIR, FORMAT error - Invalid format directive code. 

Explanation: A control file module executed a WRITE or WRITE— GROUP statement with a 
FORMAT clause that contains an invalid format directive. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-FORINVVTY, FORMAT error - Attempt to output invalid variable type. 

Explanation: A control file module executed a WRITE or WRITE— GROUP statement with a 
FORMAT clause that contains a IDP directive for which the corresponding variable is the 
wrong type. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 
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ERLRPT-F-FORLINEOV, FORMAT error - Line overflow in FORMAT clause. 

Explanation: A control module executed a WRITE or WRITE —GROUP statement during 
which the output buffer overflowed while processing the FORMAT clause. The output 
buffer is 132 characters wide. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-suppIied 
modules. 

ERLRPT-F-FORNOARG, FORMAT error - Format directive missing required argument. 

Explanation: A control file module executed a WRITE or WRITE—GROUP statement with a 
FORMAT clause that contains an !FC or !FS directive with no numeric argument. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-FORNONAME, FORMAT error - Request to print a field name for a value. 

Explanation: A control file module executed a WRITE or WRITE— GROUP statement with a 
FORMAT clause that contains a IDF directive matched with a value rather than a variable. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-FORNOREAD, FORMAT error - Attempt to print a variable without read access. 

Explanation: A control file module executed a WRITE or WRITE— GROUP statement that 
attempted to print a variable without read access. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-FORNOTASC, FORMAT clause not ASCII. 

Explanation: A control file module executed a WRITE or WRITE —GROUP statement with a 
non-ASCII FORMAT clause. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-FUNDATNOT, Specified (sub)paci<et is not large enough for offset. 

Explanation: A control file module executed a look-ahead function where the value of the 
offset argument was larger than the specified packet or subpacket. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-FUNFIELDS, Invalid conversion code argument to time conversion function. 

Explanation: A control file module executed a time conversion function with an invalid value 
for the conversion code argument. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 
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ERLRPT-F-FUNINVPOI. Invalid string pointer value in string function. 

Explanation: A control file module executed a %STR$PARSE or %STR$QUOTE function 
where the value of the pointer argument was larger than the length of the string argument. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-FUNNOTCHA, Argument to %STR$CHAR Is not in valid range for character. 

Explanation: The value of the argument for the %STR$CHAR function must be in the range 
to 127io. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-FUNNOTIMP, Function not implemented. 

Explanation: This is an internal error within RPT. 

User Action: Please submit an SPR with any information you have. 
ERLRPT-F-FUNQUOODD, Quote String in 7oSTR$QUOTE function must tiave even length. 

Explanation: A control file module executed a %STR$QUOTE function, where the quote 
string argument was not an even length. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-FUNSTRSIZ. Output string from string function too large. 

Explanation: A control file module executed a string function that resulted in a string longer 
than 255 characters. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-FUNWRONGA, Incorrect number of arguments In function call. 

Explanation: A control file module executed a function call with the wrong number of 
arguments. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-GROUPDEF. Attempt to reference undefined group. 

Explanation: A control file module attempted to reference an undefined group. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 
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ERLRPT-F-GROUPNOC, POINTER Statement executed on a group without context. 

Explanation: A control file module executed a POINTER statement on a TABLE or 
DYNAMIC—TABLE for which the current record context was not valid. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-HEAPOVERF, Heap too small to tiold value. Overflow. 

Explanation: The heap used for processing values and expressions has overflowed. 

User Action: Edit RPTBLD.CMD to increase the extension for program section VHEAPO, and 
rebuild RPT. 

ERLRPT-F-INCFORWRI, Too few FORMAT expressions in WRITE_GROUP statement. 

Explanation: A control file module executed a WRITE—GROUP statement that did not have 
two FORMAT expressions in the FORMAT clause. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-INCRDECRL, Numeric variable In INCREMENT or DECREMENT larger ttian value. 

Explanation: A control file module executed an INCREMENT or DECREMENT statement on 
a variable that was larger than a word. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-INCRDECRN, Variable in INCREMENT or DECREMENT statement not numeric. 

Explanation: A control file module executed an INCREMENT or DECREMENT statement on 
a nonnumeric variable. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-INCRDECRV, Variable in INCREMENT or DECREMENt not valid or read-only. 

Explanation: A control file module executed an INCREMENT or DECREMENT statement on 
a variable that was not both readable and writable. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-INTINVDEC, Internal error - invalid declaration entry type In WRITEGROUP. 
Explanation: This is an internal error within RPT. 
User Action: Please submit an SPR with any information you have. 

ERLRPT-F-INTVALSTK, internal error - Statement left information on value stack. 
Explanation: This is an internal error within RPT. 
User Action: Please submit an SPR wdth any information you have. 



3-42 Report Generator Task (RPT) 



ERLRPT-F-INVRADCNV. Internal error - Invalid radix code for conversion. 

Explanation: This is an internal error within RPT. 

User Action: Please submit an SPR with any information you have. 
ERLRPT-F-LEAVENOC, LEAVE statement executed outside of a conditional bloclt. 

Explanation: A control file module executed a LEAVE statement that was not inside a loop 
statement block. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-LiSTNOEXP, No expression in LIST for corresponding SEARCH variable. 

Explanation: A control file module executed a SEARCH statement in which a match was 
found, but there were not enough expressions in the list element for the number of variables 
specified in the GET clause of the SEARCH statement. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-USTNOMAT, Too many expressions In SEARCH statement for referenced LIST. 

Explanation: A control file module executed a SEARCH statement in which there were too 
many search expressions for the specified LIST. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-USTNOTDF, Group referenced In SEARCH statennent is not defined. 

Explanation: A control file module executed a SEARCH statement in which the name 
specified for the LIST was not defined. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-LISTNOTLS, Group referenced in SEARCH statennent is not a LIST. 

Explanation: A control file module executed a SEARCH statement in which the name 
specified for the LIST was not defined as a list. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-MATDIFTYP, Values Of differing type cannot be matctied. 

Explanation: A control file module executed a MATCH statement that tried to match values 
of differing types. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 
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ERLRPT-F-MATVALSIZ, Values of different size cannot be matcfied. 

Explanation: A control file module executed a MATCH statement that tried to match values 
of differing sizes. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-MEMALLFAI, Memory allocation failure - Insufficient virtual memory. 

Explanation: RPT could not dynamically extend its address space to create room for 
DYNAMIC-TABLES or control file modules. 

User Action: If the maximum task size for the partition is less than 32K words, use the MCR 
command SET /MAXEXT or DCL command SET SYSTEM/EXTENSION -LIMIT to increase 
the maximum task size, or run RPT in a different partition. If this occurs while generating 
summaries for large numbers of packets, try reducing the amount of data needed by using 
RPT switches to reduce the number of packets analyzed for each summary. 

ERLRPT-F-MEMINIFAI, IViemory allocation Initialization failure. 

Explanation: RPT could not dynamically extend its address space to create room for its data 
structures. 

User Action: If the maximum task size for the partition is less than 32K words, use the 
MCR command SET /MAXEXT or DCL command SET SYSTEM/EXTENSION _L1M1T to 
increase the maximum task size, or run RPT in a different partition. 

ERLRPT-F-MODLOAGRP, Undefined group referenced by module to be loaded. 

Explanation: The control file module being loaded attempted to reference an undefined 
group. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-MODLOASYM, Undefined symbol in module to be loaded. 

Explanation: The control file module being loaded attempted to reference an undefined 
symbol. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-MODNAMENL, IVIodule name cannot be null. 

Explanation: A control file module attempted to access another control file module that had 
a null or blank name. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 
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ERLRPT-F-MODNOMEM, Insufficient free memory to load module. 

Explanation: RPT could not dynamically extend its address space to create room for control 
file modules. 

User Action: If the maximum task size for the partition is less than 32K words, use the MCR 
command SET /MAXEXT or DCL command SET SYSTEM/EXTENSION_LIMIT to increase 
the maximum task size, or run RPT in a different partition. If this occurs while generating 
summaries for large numbers of packets, try reducing the amount of data needed by using 
other switches to reduce the number of packets analyzed for each summary. 

ERLRPT-F-MODSTART, Starting module for execution not found. 

Explanation: The control file library must contain a module named DISPATCH. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-MODZERO, Attempt to modulus by zero. 

Explanation: A control file module attempted to perform a MOD by zero. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-NOMORESTK, Execution stack overflow. 

Explanation: RPT's execution stack has overflowed. 

LZser Action: Edit RPTBLD.CMD to increase the extension for program section XCSTKO, and 
rebuild RPT. 

1 

ERLRPT-F-NOSTACKE, Internal error - Pop from execution stack withi empty stack. 

Explanation: This is an internal error within RPT. 

User Action: Please submit an SPR with any information you have. 

ERLRPT-F-NOTDYNFIL, Dynamic file operation performed on invalid group. 

Explanation: A control file module specified a group that was not defined as DYNAMIC- 
TABLE in a statement or operation requiring a DYNAMIC—TABLE. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-NOTPOiNT, POINTER LOAD or MOVE executed witli a non-pointer variable. 

Explanation: A conttol file module executed a POINTER LOAD or MOVE with a variable 
that was not a pointer. 

User Action: Correct the user-written module or submit an SPR for, DIGITAL-supplied 
modules. 
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ERLRPT-F-NOTPOIVAR, POINTER LOAD with no pointer variable specified. 

Explanation: A control file module executed a POINTER LOAD or MOVE with no variable 
specified. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-NUIVIINVOPR, Invalid numeric double-operand operation code. 
Explanation: This is an internal error within RPT. 
User Action: Please submit an SPR with any information you have. 

ERLRPT-F-OPRINVLOG, Attempt to perform logical operation on an invalid type. 

Explanation: A control file module attempted to perform a logical operation with operands 
that were neither NUMERIC nor LOGICAL. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-OPRNOTIMP, Operation not implemented. 

Explanation: A control file module attempted to perform a multiplication where both 
operands were larger than a word value. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-PACKETSIZ, illegal pocket size. 

Explanation: The size of an error log packet was zero or would cause the packet to cross a 
block boundary. 

User Action: Please submit an SPR with any information you have. 

ERLRPT-F-POISETGRP, POINTER variable is not from correct group in POINTER ... LOAD or MOVE. 

Explanation: A control file module executed a POINTER LOAD or MOVE statement in 
which the optional pointer variable was not a pointer to the specified DYNAMIC—TABLE. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-POISETIVIOD, POINTER variable is from wrong module in POINTER ... LOAD or IVIOVE. 

Explanation: A control file module executed a POINTER LOAD or MOVE statement in 
which the DYNAMIC—TABLE pointed to by the optional pointer variable was not in the 
same module as the DYNAMIC—TABLE specified in the POINTER statement. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 
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ERLRPT-F-POISETSIZ, Group too small for POINTER In POINTER ... LOAD or MOVE. 

Explanation: A control file module executed a POINTER LOAD or MOVE statement in which 
the optional pointer variable was pointing past the end of the specified DYNAMIC—TABLE. 

User Action: Correct the user- written module or submit an SPR for DlGITAL-supplied 
modules. 

ERLRPT-F-PROCNAMEN, Null procedure name. 

Explanation: A control file module specified a null or blank procedure name in a CALL or 
ENABLE statement. 

User Action: Correct the user-written module or submit an SPR for DlGITAL-supplied 
modules. 

ERLRPT-F-RAD50BYTE, Cannot convert a byte using Radix-50 conversion. 

Explanation: A control file module attempted to convert an ASCII string or numeric literal 
to a BYTE using Radix-50 conversion. 

User Action: Correct the user-written module or submit an SPR for DlGITAL-supplied 
modules. 

ERLRPT-F-RELINVCOD, Invalid relational operator. 
Explanation: This is an internal error within RPT. 
User Action: Please submit an SPR with any information you have. 

ERLRPT-F-RETURNNOC, A RETURN was executed with no corresponding CALL. 

Explanation: A control file module executed a RETURN statement outside of a procedure or 
coroutine. 

User Action: Correct the user-vratten module or submit an SPR for DlGITAL-supplied 
modules. 

ERLRPT-F-SELECTNOM, SELECT statement Index has no matching statement block. 

Explanation: A control file module executed a SELECT statement with no statement block 
to match the value of the numeric control expression. 

User Action: Correct the user-written module or submit an SPR for DlGITAL-supplied 
modules. 

ERLRPT-F-SIGNOTASC, Parameter or message In SIGNAL-class statement not ASCII. 

Explanation: A control file module executed a SIGNAL, SIGNAL _STOP, or MESSAGE 
statement with a non-ASCII argument. 

User Action: Correct the user-written module or subnut an SPR for DlGITAL-supplied 
modules. 
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ERLRPT-F-SIGTOOBIG, Message and parameters in SIGNAL-class statement too long. 

Explanation: A control file module executed a SIGNAL, SIGNAL —STOP, or MESSAGE 
statement in which the length of the concatenated message and parameters was longer than 
255 characters. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-suppIied 
modules. 

ERLRPT-F-SIGTOOMAN, Cannot issue a SIGNAL during SIGNAL processing. 

Explanation: A control file module executed a SIGNAL or SIGNAL _STOP statement while 
processing a previous SIGNAL or SIGNAL —STOP. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-STANOTIMP, Statement not implemented. 
Explanation: This is an internal error within RPT. 
User Action: Please submit an SPR with any information you have. 

ERLRPT-F-STANOTVAL, Internal error - Invalid statement code. 
Explanation: This is an internal error within RPT. 
User Action: Please submit an SPR with any information you have. 

ERLRPT-F-SUBEXTBIG, Substring extraction end element exceeds string. 

Explanation: A control file module attempted to perform a substring extraction in which the 
substring exceeded the end of the string. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-SUBPKTSIZ, Illegal subpacket size. 

Explanation: The current subpacket exceeded the bounds of the packet. 
User Action: Please submit an SPR with any information you have. 

ERLRPT-F-UNDEFPROC, Specified procedure not found. 

Explanation: A control file module has executed a CALL statement, and the specified 
procedure was not found. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-UNDMODULE, Specified module not found. 

Explanation: A control file module has executed a CALL statement, and the specified module 
was not found. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 
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ERLRPT-F-VALSTKOVR, Value stack overflow. 

Explanation: The stack used for processing values and expressions has overflowed. 

User Action: Edit RPTBLD.CMD to increase the extension for program section VLSTKO, and 
rebuild RPT. 

ERLRPT-F-VALUESIZE, Value in expression is too large. 

Explanation: A control file module evaluated an expression in which an intermediate value 
or the final value was too large. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-VALUETYPE, Value In expression Is wrong type. 

Explanation: A control file module evaluated an expression in which an intermediate value 
or the final value was of the wrong type. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-VARNOCONT, Attempt to access variable in group withiout context. 

Explanation: A control file module attempted to reference a variable for a TABLE, 
DYNAMIC_TABLE, or PACKET or SUBPACKET with the REPEATED attribute for which 
the current record context was not valid. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-VARNODATA, Attempt to occess variable in group with no data. 

Explanation: A control file module attempted to reference a variable for a TABLE, 
DYNAMIC-TABLE, or PACKET or SUBPACKET with no data. 

User Action: Correct the user- written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-VARNOTDAT, Attempt to load data into a BIT or FIELD variable. 

Explanation: A control file module attempted to load a value into a BIT or FIELD in a group, 
rather than into the data item for which the BIT or FIELD was defined. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLRPT-F-WRITEACCV, Attempt to load a value into a non-writeable variable. 

Explanation: A control file module attempted to load a value into a data item in a PACKET, 
SUBPACKET, or TABLE. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 
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Chapter 4 

Error Log Control File Architecture 



This chapter describes the architecture of error log control files. A knowledgeable system 
programmer can use the information presented here to add user-written modules to the error 
logging system. 

This chapter includes the following sections: 

• Section 4.1 defines the most important terms and concepts presented in this chapter. 

• Section 4.2 describes the control file modules, the flow of program control through 
the modules, module compilation paths, and how to recompile modules after making 
modifications. 

• Section 4.3 describes the interaction between a dispatcher module and a device-level module. 

• Section 4.4 explains event-level and device- or CPU-level dispatching. 

• Section 4.5 provides the information you need to include error logging support for non- 
DIGITAL devices. 

• Section 4.6 includes annotated listings of source code for three modules: ERM23, DSP2P1, 
and NRM23. The source code is keyed to discussions in Sections 4.3 and 4.5 of this chapter. 
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4. 1 Terms and Concepts 

The following are definitions of the most important terms and concepts presented in this chapter: 



Control file 



Module 



A collection of modules that together perform a function, such as 
processing error log files. 

A component of the error logging system. There are three kinds of 
modules: source modules, which have the file type CNF, object modules, 
which have the file type ICF, and listing modules, which have the file 
type LST. 

Control File Language The language in which control files are written. The Control File 
Language (CFL) is described in Chapter 5. 

The file that contains the raw error logging data. One record in the 
file corresponds to one event. The default specification for this file is 
LB:[l,6]LOG.ERR. 

Something that is logged in the error log file. An event may be the 
recording of an actual device error or it could be some informational 
data, such as a device mount or a change in system time. 



Error log file 



Event 



Packets, subpackets 



Each record (or event) is also a packet. A packet begins with a length 
word and is followed by data, which can consist of zero or more 
subpackets. A subpacket also consists of a length word followed by 
data. Every packet in the error logging system contains at least one 
subpacket. 

Note 

The packet length word begins the packet, but it is not part of the packet; the 
packet length word is kept by FCS. Therefore, the packet length word is not 
included in the length of the packet. However, the subpacket length words are 
part of the packet and are included in its length. This is consistent throughout 
the error logging system. See Figure 4-1 for the general structure of an error 
logging packet. 

4.2 Control File Module Arctiitecture 

The error logging system is modular; that is, information and dependencies specific to different 
devices are isolated in modules written for each device. This section describes the architecture 
of the control file modules: the modules themselves, the flow of program control through the 
modules^ the compilation paths, and how you can modify and recompile the modules. 
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Figure 4-1 : Structure of Error Logging Pacl<et 
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4.2.1 The Control File Modules 

The following descriptions briefly explain the function of each of the control file modules: 

DISPATCH 

The DISPATCH module (the root module for the error logging system) declares all commonly 
used variables, calls the INITMl module to initialize the system, and calls the PARSEM 
module to obtain and parse the command line. DISPATCH then requests the records 
from the input log file, declares the common subpackets (HEADER, TASK, DEVICE _ID, 
DEVICE-OPERATION, and DEVICE -ACTIVITY) for each record, computes the correct 
dispatcher module name, and calls that module. When all the records are processed, it calls 
the summary modules (if requested) and then calls the FINLPl module to clean up. 

See Section 4.6.4 for the definitions of the standard DIGITAL subpackets. Dispatching is 
described in more detail in Section 4.4. 

PARSEM 

The PARSEM module declares variables local to the processing of the command line and 
calls the PARSIM module to obtain the command line. It then calls the PARS2M module 
to process any switches and the PARS3M module to open the various files. PARSEM also 
provides commordy used parsing routines to the other parsing modules. 

PARSIM 

The PARSIM module initializes parsing variables and gets the command line from RPT. It 
then breaks all of the file specifications out of the command line, leaving all of the switches. 
PARSIM then searches for the /REPORT switch. If it finds the switch, PARSIM replaces 
it with the specified string of predefined switches. 

PARS2M 

The PARS2M module gets a switch from the string of switches produced by the PARSIM 
module. It then checks the switch for ambiguity and calls the PRS2AM module to process 
the switch. If PRS2AM does not recognize the switch, it is passed to the PRS2BM module. 
PARS2M repeats this process until all switches have been processed. 

PRS2AM 

The PRS2AM module processes the following switches: /DATE, /DEVICE, and /PACKET. 

PRS2BM 

The PRS2BM module processes the following switches: /FORMAT, /SERIAL, /SUMMARY, 
/TYPE, /VOLUME, and /WIDTH. 

PARS3M 

The PARS3M module applies the defauh values to any switches that were not specified and 
opens the specified files. 

SELTMl 

The SELTMl module is called by the DISPATCH module to determine if the current packet 
meets the selection criteria of the command line switches. 
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DSPIPI 

The DSPIPI module processes error log control events (see Section 4.4.1). These modules 
declare the DATA subpacket for each type of event and process the event to completion, 
calling the formatter modules to print the common data if the FULL report format is 
specified. 

DSP2P1 

The DSP2P1 module processes device error events (see Section 4.4.1). These modules call 
the DEVSMl module to determine the name of the device-level module required to process 
the event and then calls that module as a coroutine and passes control to it. The device-level 
module declares the DATA subpacket and then extracts information from the registers of 
the logged device so it can provide additional selection information. 

When the device-level module returns control to DSP2P1, it performs the last of the selection 
tests and makes the decision whether to continue with this event or not. If DSP2P1 decides 
to continue, and if the FULL report format has been specified, DSP2P1 calls the formatter 
modules to print the common information. Once printing is completed, control returns to 
the device-level module, which prints the device registers. 

If the BRIEF report has been specified, DSP2P1 still must decide whether to continue, but 
there is no need for the formatter modules: DSP2P1 does its own printing. 

Once all the printing is completed, the error logging system tests to see if this entry belongs 
in any summaries. If so, DSP2P1 places the data relevant to each requested summary in 
the summary files. 

DSP3P1 

The DSP3P1 module processes device information events (see Section 4.4.1). It performs 
the same function as the DSP2P1 module, but only for device errors not related to I/O. 
This module is required only if you have a TU78 or Mass Storage Confa-ol Protocol (MSCP) 
device. 

DSP4P1 

The DSP4P1 module processes device control information events (see Section 4.4.1). DSP4P1 
calls the DEVSMl module to get the type of device associated with the device mnemonic. 

Mount, dismount, and reset operations have no DATA subpacket. The formatter modules 
print the information if the FULL report mode is specified; otherwise, the module does all 
the printing itself. As with the DSP2P1 and DSP3P1 modules, DSP4P1 records summary 
information if requested. 

The block replacement event does have a DATA subpacket, which is processed entirely by 
this module. This type of event does not contribute to summaries. 

DSP5P1 

The DSP5P1 module processes events detected by the CPU (see Section 4.4.3). DSP5P1 
gets the CPU type from the HEADER subpacket declared by DISPATCH and calls the 
appropriate CPU-level module as a coroutine if the event was a memory parity error. The 
processing then proceeds much like that for device errors. 

If the event was an unknown interrupt, the module declares and processes the DATA 
subpacket itself. 
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DSP6P1 

The DSP6P1 module processes system control information events (see Section 4.4). There is 
no DATA subpacket associated with the power recovery event. DSP6P1 calls the formatter 
modules to print the common data if the FULL report format is specified; otherwise, the 
module does all the printing itself. 

DSP7P1 

The DSP7P1 module processes control information events (see Section 4.4). This module 
declares the DATA subpacket for each type of event and processes the event to completion, 
calling the formatter modules to print the common data if the FULL report format is 
specified. 

DSP8P1 

The DSP8P1 module processes control information events (see Section 4.4). This module 
uses the DATA subpacket to extract information for unknown interrupts. It also formats the 
output for unknown interrupt CPU-detected error packets. 

FINLPl 

The FINLPl module is called by the DISPATCH module to perform cleanup operations 
after all the error log events are processed. 

FINLPl also creates the final page of the error log report. This page contains such 
information as the command line entered by the user, the files used, the switch states, the 
number of events processed, and how long it took to generate the report. 

FMTNPl and FMTWPl 

FMTNPl and FMTWPl are formatter modules that print the first page of a full report; that is, 
all of the information from the HEADER, TASK, DEVICE_ID, DEVICE -OPERATION, and 
DEVICE -ACTIVITY subpackets. FMTNPl prints reports in narrow format, and FMTWPl 
prints reports in wide format. 

DEVSM1 

The DEVSMl module is called by the DSP2P1, DSP3P1, and DSP4P1 modules to provide 
certain device-related information. DSP2P1 and DSP3P1 call it to find, among other things, 
the name of the device-level module that should help process the event. DSP4P1 calls 
DEVSMl to find out the name of the device associated with a device mnemonic. 

If the device mnemonic is DU, DEVSMl then calls DEVUDA to do most of the processing. 

DEVUDA 

The DEVUDA module is called only by DEVSMl. It assists DEVSMl in the processing of 
events on MSCP DU-type devices. 

ERRORM 

The ERRORM module is the error processor for the error logging system. Whenever a 
SIGNAL or SIGNAL -STOP procedure occurs, ERRORM processes the error. 

SMRYEP 

The SMRYEP module prints ERROR summaries. DISPATCH calls SMRYEP after all packets 
have been processed if an ERROR summary was requested. 
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SMRYGP 

The SMRYGP module prints GEOMETRY summaries. DISPATCH calls SMRYGP after all 
packets have been processed if a GEOMETRY summary was requested. 

SMRYHP 

The SMRYHP module prints HISTORY summaries. DISPATCH calls SMRYHP after all 
packets have been processed if a HISTORY summary was requested. 

CPU-level modules 

There are four CPU-level modules, all with names derived from their associated processors. 
They are called as coroutines by DSP5P1 to process memory parity errors. The modules 
are as follows: 

E1144 Processes errors from the PDP-11/44 processor 

E117X Processes errors from the PDP-11/70 and PDP-11/74 processors 

E118X Processes errors from the PDP-11/73, PDP-11/83, and PDP-11/84 processors 

EllXX Processes errors from all other PDP-11 processors 

EUNKWN 

EUNKWN is a universal device-level or CPU-level module. EUNKWN is called if a 
particular device-level module is unavailable or if the device mnemonic is unknown to the 
error logging system. EUNKWN is also called if the CPU type is unknown. 

EUNKWN produces a formatted dump of the data, showing the relative offset within the 
data, and the data itself in octal word, octal high-byte, octal low-byte, and binary word 
format. See Section 4.5 for more information on error logging from unknown devices. 

DMPALL 

The DMPALL module is similar to EUNKWN. DMPALL is called if the packet cannot be 
processed due to an error in format or structure. DISPATCH calls DMPALL if the packet 
fails any sanity check. 

DMPALL produces a formatted dump of the data, showing the relative offset within the 
data, and the data itself in octal word, octal high-byte, octal low-byte, and binary word 
format. 

Device-level modules 

Device-level modules contain details of the bit-to-text translation for all supported error 
logging devices. The DSP2P1 and DSP3P1 modules call them as coroutines. Their names 
are derived from the names of the associated devices. 

See Section 4.5 for information on how these modules are constructed and how you can 
write device-level modules for unsupported devices. 

Table 4-1 lists the standard error logging device-level modules. 
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Table 4-1: Error Logging Device-Level Modules 



Module Name Module Description 



EMLll 

ERK05 

ERK67 

ERL12 

RM05 

ERM23 

ERM80 

ERP07 

ERP23 

ERP456 

ERSll 

ERS34 

ERXOl 

RX02 

ET0310 

ET1645 

ETAll 

ETCH 

ETK50 

ETK70 

ETSll 

ETSV05 

ETU58 

ETU77 

ETU81 

MSCP5X 

MSCP60 
MSCP80 
MSCPAT 



Processes ML 11 errors 

Processes RK03 and RK05 errors 

Processes RK06 and RK07 errors 

Processes RLOl and RL02 errors 

Processes RM05 errors 

Processes RM02 and RM03 errors 

Processes RM80 errors 

Processes RP07 errors 

Processes RP02 and RP03 errors 

Processes RP04, RP05, and RP06 errors 

Processes RSll errors 

Processes RS03 and RS04 errors 

Processes RXOl errors 

Processes RX02 errors 

Processes TS03, TEIO, and TUlO errors 

Processes TE16, TU16, and TU45 errors 

Processes TAll errors 

Processes TCll errors 

Processes TK50 errors 

Processes TK70 errors 

Processes TSll, TU80 errors 

Processes TSV05 errors 

Processes TU58 errors 

Processes TU77 errors 

Processes TU81 errors 

Processes errors for RD50, RD51, RD52, RD53, RD54, RX33, and RX50 
devices 

Processes MSCP RA60 errors 

Processes MSCP RA80, RA81, and RA82 errors 

Processes MSCP attention errors 
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Table 4-1 (Cont.): Error Logging Device-Level Modules 



Module Name Module Description 



MSCPCE Processes MSCP controller errors 

MSCPEN Processes MSCP end packets 

MSCPSD Processes MSCP RC25 errors 

MSCPTO Processes MSCP timeout errors 

TMSCPE Processes TMSCP end packets 



Notes modules 

Notes modules contain notes for error conditions that need additional explanation. Notes 
modules are device-specific and have names derived from the names of the associated 
device-level module. See Section 4.5.3.2 for more information on how these modules are 
constructed. 

Table 4-2 lists the standard error logging notes modules. 
Table 4-2: Error Logging Notes Modules 



Module Name Module Description 



NMLll Processes MLll notes 

NRK67 Processes RK06 and RK07 notes 

NRM05 Processes RM05 notes 

NRM23 Processes RM02 and RM03 notes 

NT0310 Processes TS03, TEIO, and TUlO notes 

NTSll Processes TSll and TU80 notes 



4.2.2 Program Control Flow 

The general flow of program control through the control file modules is as follows: 

1. RPT opens the control file. In most cases, this is the default control file LX or 
LB:[l,6]ERRLOG.ULB. If you wish to use some other filespec, RPT must be rebuilt to 
prompt for the new name of the file. 

2. RPT creates the module table in its dynamic work space. This table contains an entry for 
each module in the control file universal library. 

3. RPT loads the DISPATCH module and transfers control to the ENTRY procedure. 

4. The ENTRY procedure is similar to the root module in most MACRO-11 programs. The 
general flow of the ENTRY procedure is as follows: 

a. Declares most of the commonly used data structures. 

b. Enables the ERROR_l procedure in the ERRORM module as an error handler. 
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c. Fetches and parses the command line by calling the SETUP procedure in the PARSEM 
module. 

d. Performs some general initialization with the INIT_1 procedure from INITMI. 

e. Sets up a loop to step through the PACKET—RANGE file, extracting pairs of packet 
ranges which are fed back to RPT. 

f. Loops through the current packet range, requesting each packet in turn and calling 
the DISPATCH procedure in the DISPATCH module. This step is performed for each 
packet range. 

g. When all packets and packet ranges have been requested, ENTRY generates summaries, 
if requested, by calling the SUM_ERROR, SUM_GEOMETRY, and SUM_HISTORY 
procedures from SMRYEP, SMRYGP, and SMRYHP, respectively. 

h. Calls the FINAL _1 procedure in FINLPl to perform cleanup operations. 

5. The DISPATCH procedure in the DISPATCH module declares all of the common subpackets. 
In order of appearance, these are the HEADER, TASK, DEVICE_ID, DEVICE_OP, and IO_ 
ACTIVITY subpackets. 

Each of these subpackets has a mask bit in the HEADER subpacket to indicate the presence 
of the subpacket. If the bit is set, the subpacket is present and therefore declared. If the bit 
is not set, the subpacket is not present and consequently not declared. 

Note that the HEADER subpacket must always be present. 

As each subpacket is declared, various tests are performed that must be passed. (These tests 
are for the various selection criteria that you can specify using command line qualifiers.) 
If one subpacket fails the tests, the entire packet is rejected. If the tests are passed, the 
procedure then computes the name of the appropriate dispatcher module. 

The dispatcher module name is concatenated from the following elements: 

• The string "DSP" 

• The event code (HEADER.CODE_TYPE) converted to ASCII decimal 

• The string "PI" 

For example, an event with a code of 5 would be dispatched to the DSP5P1 module. 

6. The dispatcher modules (or the modules they may call) handle the declaration of the DATA 
subpacket if one is present. The dispatcher modules also perform further selection tests 
as needed to determine whether or not information about the event should be printed. 
Brief format reports are printed entirely by the dispatcher module. Full and register format 
reports are printed by a combination of the following modules: 

• One of the formatter modules (FMTNPl or FMTWPl) 

• The appropriate dispatcher module 

• A device-level module (if it is a device error) or a CPU-level module (if it is a processor 
or memory error) 
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4.2.3 Compilation Patiis 

The DISPATCH module must be compiled first. The next modules to be compiled are at the 
next level. These modules — ERRORM, DSP2P1, DSPIPI, DSP5P1, SMRYEP, and PARSEM 
— all use the symbol file produced from the compilation of DISPATCH as input. Modules in 
the same group (for example, ERRORM, INITPl, SELTMl, and FINLPl) all use the same input 
symbol file (in this case, DISPATCH) and can be compiled in any order. 

Figure 4-2 illustrates the compilation paths for the control file modules. 
Figure 4-2: Compilation Path for Control File Modules 
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Where modules in the figure are connected by vertical lines, the upper module is compiled first. 
The lower module or modules are then compiled using the symbol file produced by the module 
at the next higher level. Therefore, the DSP2P1 module is compiled using the symbol file firom 
DISPATCH, the DEVSMl module is compiled using the s3mibol file from DSP2P1, and so on. 

Modules used in the error logging system must be compiled using the following compile-time 
literal declarations: 

Option> LITERAL SUPPORT. RSX.llM = FALSE 

Option> LITERAL SUPPORT. RSX_HM_PLUS = TRUE 

Option> LITERAL SUPPORT . INACTIVITY = TRUE 
Option> / 

See Chapter 5 for a description of the Control File Language (CFL), which is used in these 
declarations. 
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4.2.4 Modification and Recompilation 

You can modify any control file module. After doing so, you must recompile the module and 
replace it in the control file library. 

Caution 

You must recompile all modules on the same branch of the tree at levels lower 
than the modified module if your modification includes any of the following 
changes: 

• Creates new groups, tables, or dynamic tables 

• Creates a new variable within any of these structures 

• Reorders a variable vsdthin any of these structures 

Note that you need not recompile lower-level modules if you modify the run-time logic. For 
example, suppose you want to modify the following statement in the PARSEM module: 

IF XSTR$LENGTH(PARSE.SWITCH_LIST) EQ 

Your modification is as follows: 

IF 7,STR$LENGTH(PARSE.SWITCH_LIST) EQ 1 

This modification in the PARSEM module would not require recompiling any of the lower-level 
modules (PARSIM, PARS2M, PARS3M, PRS2AM, or PRS2BM). 

Now, suppose you modify the same statement as follows: 

IF XSTRSLENGTHCPARSE.SWT.LIST) EQ 1 

In this example, you created the variable SWT_LIST in the PARSE group. Therefore, you must 
recompile the lower-level modules. This is because the information in the symbol file consists 
of group names (in alphabetical order) and the variables defined writhin the group (in the order 
declared). The compiler uses the information from the input symbol file to compute relative 
group and variable numbers for use when a module references a group or variable declared in 
a higher-level module. These group and variable numbers (rather than the names) are used to 
resolve references to groups and variables when a module is loaded. Defining new groups, or 
variables within a group, changes the relative order of these symbols. 

4.3 Interaction Between Dispatcher and Device-Level Modules 

The following section describes in detail the interaction between a dispatcher module and a 
device-level module, using the processing of an RM03 error as an example. 

The following discussion refers to the ERM23 device-level module code in Section 4.6.1 and 
the DSP2P1 dispatcher module code in Section 4.6.2. Both the discussion here and the code in 
those two sections are keyed to each other by the module names (either ERM23 or DSP2M1) 
and numbers that look like this: O. 

You may wish to remove the pages for Sections 4.6.1 and 4.6.2 from your book for easier 
reference in following the interaction between these two modules. 

Processing in DSP2P1 begins when the DISPATCH module has declared all subpackets except 
for the DATA subpacket. All subpackets except for the TASK subpacket are needed for a device 
error. 
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DSP2P1 first declares the logical variable INDICATE.TAPE_FLAG (DSP2P1 O). This variable 
is set by DEVSMl to indicate whether or r\ot the device is a magnetic tape. The variable is 
used later in processing summary information. 

DSP2P1 determines that peripheral errors are requested and that the subcode is valid. Having 
completed these checks, DSP2P1 calls DEVSMl (DSP2P1 ©). DEVSMl returns device 
information in the following three variables: 

• INTERMOD_DEVERR.DISP_NAME contains the name of the device-level module needed 
to process the DATA subpacket, in this case ERM23. 

• INTERMOD_DEVERR.DRIVE_TYPE contains the string RM03 for the drive type. 

• INTERMOD_DEVERR.ALT_NAME contains the string RM02/03 for the alternate drive 
type. (The alternate name variable is not used during device error processing.) 

After returning from DEVSMl, the NOTE_NUMBERS file is cleared (DSP2P1 ©). Clearing the 
file deletes any records that may remain there from previous events. 

The next step establishes the coroutine relationship with the device-level module (DSP2P1 O). 
The DEVICE -ERROR procedure in the DSP2P1 module is one partner, while the DEVICE— 
ENTRY procedure in the ERM23 module is the other. Control passes to the DEVICE -ERROR 
procedure. 

The first thing the DEVICE—ERROR procedure does is pass control to its partner (DSP2P1 ©). 
Module ERM23 receives control at the beginning of the DEVICE -ENTRY procedure (ERM23 

©). 

The DEVICE-ENTRY procedure declares the DATA subpacket (ERM23 ®). Once this is 
completed, the INTERMOD-DEVERR variables are filled in (ERM23 © and ©). All of the 
variables must be filled in. If the information for a particular variable is unavailable or not 
applicable, use the string N/A. For the variable INTERMOD_DEVERR.ERROR -CYLINDER, 
the string ??? also has a special meaning: It indicates to DSP2P1 that the section titled Device 
Error Position Information is to be suppressed. 

Once the INTERMOD-DEVERR variables are all filled in, a coroutine statement returns control 
to DEVICE -ERROR (ERM23 ©). DEVICE -ERROR regains control where it left off (DSP2P1 

©). 

DSP2P1 then performs the serial number tests, if required, after having first initialized the 
variable INTERMOD_DEVERR.REJECT-FLAG to false. If the serial number test is failed, the 
variable INTERMOD-DEVERR.REJECT_FLAG is set to true. 

The path through the two modules now depends on the report format, either BRIEF, FULL, 
REGISTER, or NONE. The following paragraphs explain these paths: 

BRIEF 

The REJECT-FLAG variable is tested (DSP2P1 ©). If true, there is no output. If false, one 
line is printed which contains the information required for a BRIEF report. In either case, 
the variable INTERMOD-DEVERR.PRINT-FLAG is set to false. 

If the packet is not rejected and if the report format is not NONE, the variable REPORT. 
PRINT-COUNT is incremented. This variable keeps a count of how many events were 
printed (as opposed to how many were looked at, which is a separate tally). 
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FULL 

The REJECT—FLAG variable is tested (DSP2P1 ©). If it is set to true, there is no output 
and the PRINT_FLAG variable is set to false. 

If REJECT—FLAG is set to false, the formatter modules are called to print the information 
from the common subpackets. The DSP2P1 module then prints (still on the first page) 
the information passed back in the INTERMOD_DEVERR variables filled in by ERM23. 
DSP2P1 generates a page break, then prints a header on the second page. When done, 
DSP2P1 sets the PRINT-FLAG variable to true. 

REGISTER 

The REGISTER path is almost identical to the FULL path. The only difference is that the 
page containing all of the common information is not printed. The header on the page 
containing the register translation supplies a summary of the information instead. 

NONE 

The NONE path sets the PRINT-FLAG variable to false (DSP2P1 @). 

All of these paths converge again at DSP2P1 (©), where control once again passes to the 
DEVICE-ENTRY procedure in ERM23. 

The first thing the DEVICE— ENTRY procedure does upon regaining control is to test the 
PRINT-FLAG variable (ERM23 ©). If it is set to FALSE, the module exits (ERM23 ®). 

If the PRINT—FLAG variable is set to true, ERM23 performs the bit-to-text translation of the 
registers. Following that, any required notes are indicated by PUT statements to the NOTE- 
NUMBERS file specifying the note index (ERM23 ®). The module then exits (ERM23 ®). 

When ERM23 exits, the DSP2P1 module regains control and the coroutine partnership is broken 
(DSP2P1 (D). 

After the device-level module has printed (if instructed to) and has exited back to the DSP2P1 
module, the UPDATE-RECORD procedure in DSP2P1 is called (DSP2P1 ®). 

The UPDATE —RECORD procedure tests to see if an ERROR summary was requested (DSP2P1 
®). If none was requested, processing goes on to the GEOMETRY section. 

If an ERROR summary was requested, the DSP2P1 module searches the ERROR_INFO_E file 
to see if an error having the same error type has been encountered. If the same error type has 
been encountered, the record in the file describing that type of error is updated to show that 
one more error occurred, and when it occurred. If no such error is found in the file, a new 
record that describes the error is added to the file and processing goes on to the GEOMETRY 
section. 

The UPDATE -RECORD procedure then tests to see if a GEOMETRY summary was requested 
(DSP2P1 ®). If not, the procedure exits. 

Updating the ERROR_INFO-G file is much the same as updating the ERROR-INFO_E file, 
but the information recorded is somewhat different. In particular, the GEOMETRY summary 
indicates where on the device the error occurred. Since magnetic tapes have no valid geometry 
information, when updating the ERROR -INFO— G file you need to know whether or not the 
device is a magnetic tape. 
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Finally, the DEVICE-ERROR procedure checks for entries in the NOTE-NUMBERS file. If 
there are any entries, DSP2P1 computes the name of the notes file. The name of a notes 
module is the same as its corresponding device-level module, except that the first character of 
the module name is the letter N. In this case, the module name is NRM23. The notes module 
is called to print the requested notes. 

4.4 Dispatching 

This section discusses module dispatching. There are two levels of dispatching: event-level 
dispatching and device- or CPU-level dispatching. 

4.4.1 Event-Level Dispatching 

All events that occur in the error logging system are assigned a unique combination of code 
and subcode. These code and subcode combinations can be found in the file EPKDF.MAC 
(EPKDF$ macro in EXEMC.MLB) along with the definition of the structure of error log packets. 
See Appendix C for a listing of EPKDF$. Table 4-3 summarizes the error logging code and 
subcode combinations. 



Table 4-3: Error Logging Code and Subcode Combinations 



Code 



Subcode 



1. Error Log Control 



1. Error Log Status Change 

2. Switch Logging Files 

3. Append File 

4. Declare Backup File 

5. Show (not logged) 

6. Change Limits 



2. Device Errors 



1. Device Hard Error 

2. Device Soft Error 

3. Device Interrupt Timeout (hard) 

4. Spurious Interrupt 

5. Device Interrupt Timeout (soft) 



3. Device Information 



1. Device Information Message 



4. Device Control Information 



1. Device Mount 

2. Device Dismount 
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Table 4-3 (Cont.): Error Logging Code and Subcode Combinations 



Code 



Subcode 



3. Device Counts Reset 

4. Block Replacement 



5. Memory_Info Errors 



1. Memory Error 



6. System Control Information 



1. Power Recovery 



7. Control Information 



1. Time Change 

2. System Crash 

3. Device Driver Load 

4. Device Driver Unload 

5. Message 



8. CPU-Detected Errors 



2. Unexpected Interrupt 



Each code group is processed by one of the dispatcher modules. These modules are named 
DSPIPI through DSP7P1. The name of the dispatcher module is concatenated in the DISPATCH 
module's DISPATCH procedure from the following elements: 

• The string "DSP" 

• The event code (HEADER.CODE_TYPE) converted to ASCII decimal 

• The string "PI" 

The single-digit ASCII conversion of the code value (obtained from the HEADER subpacket) 
is required because the Librarian Program Utility (LBR) allows a maximum of six Radix-50 
characters for a module name. The code value 9 is currently unused; values and 8 are 
reserved. 

Once the dispatcher module has been called, it checks to see if this type of event was requested. 
If the event type was not requested, the module returns, effectively ignoring the entry. Event 
types are requested by using the /TYPE switch. The event types, codes, and the dispatcher 
modules that process them are listed in Table 4-4. 
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Table 4-4: Event Types, Codes, and Their Dispatcher Modules 



Type 



Codes Dispatcher Modules 



ALL 


1-7 


DSPIPI, 


..., DSP7P1 


CONTROL 


1 


DSPIPI 




ERRORS 


2,3,5 


DSP2P1, 


DSP3P1, DSP5P1 


MEMORY 


5 


DSP5P1 




PERIPHERAL 


2,3 


DSP2P1, 


DSP3P1 


PROCESSOR 


5 


DSP5P1 




SYSTEM_INFO 


4,6,7 


DSP4P1, 


DSP6P1, DSP7P1 


CPU_INFO 


8 


DSP8P1 





Once the dispatcher module determines that this type of event was requested, it checks to see 
if the subcode is in range. If it is not, the event is rejected with an error message. 

At this point, dispatcher modules may declare and print the DATA subpacket themselves or 
they may call lower-level modules to do so. The error logging dispatcher modules handle all 
of the printing for the brief report mode. If the full report mode is specified, the dispatcher 
modules call one of the following modules to print the common portions of the event: 



Width 



Formatter Module 



NARROW 
WIDE 



FMTNPl 
FMTWPl 



The dispatcher module may print the rest of the event itself or work with a lower-level module. 

4.4.2 Device-Level Dispatching 

Device-level dispatching is performed with the assistance of the DEVSMl module. This module 
is called by the DSP2P1, DSP3P1, and DSP4P1 modules and determines, among other things, 
the correct device-level module for the event. 

The following paragraphs describe how the DEVSMl module works (see the source code for 
exceptional cases; this discussion addresses only common cases). 

The first thing DEVSMl checks is whether there is a DEVICE-ID subpacket. If no DEVICE_ID 
subpacket is found, an error results. Once past that check, DEVSMl uses the device mnemonic 
to search the DEVICE_INFO table. If the device is not found, DEVSMl specifies the EUNKWN 
module in the variable INTERM0D_DEVERR.D1SP_NAME. 

Assuming that the mnemonic is recognized, the DEVSMl module tests to see if (a) the mnemonic 
is that of a MASSBUS device, and (b) there is a DATA subpacket. Assuming both are true, 
DEVSMl looks ahead into the DATA subpacket to obtain the MASSBUS Drive Type from the 
logged registers. 
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The drive-type value is unique for each MASSBUS device. Once this value is obtained, the 
DEVICE —INFO table is searched again, this time using the drive-type value as the key. If this 
search succeeds, the INTERMOD_DEVERR.DISP_NAME variable is filled in with the module 
name specified by the resulting record in the table. 

If there is no DATA subpacket, or if the device is not a MASSBUS device, the search of the table 
is left pointing to the first record that matched on the specified mnemonic. DEVSMl performs a 
further search of the table based on the mnemonic as well as the device size (which is provided 
in the DEVICE _ID.DEV_TYPE variable). The INTERMOD_DEVERR.DISP_NAME variable is 
then filled in with the module name specified in the record (the result of this search). 

The search proceeds in the following order: 

1. When a device's mnemonic is found in the DEVICE_INFO table in module DEVSMl, the 
MASSBUS_FLAG is checked. If it is true, a look-ahead into the device registers returns the 
device's DRIVE_TYPE. 

2. The DEVICE —INFO table is then searched again to find a record having that drive type. 

3. The error logging system then dispatches to the module corresponding to the actual registers 
logged, rather than dispatching to the module indicated by the mnemonic provided in the 
Executive. 

For MASSBUS devices, the error logging system uses the device name provided by the DEVICE— 
INFO table. This name will always be correct, since each MASSBUS device has a unique drive- 
type value. If there is a mismatch between the mnemonic supplied and the device type as 
determined by examining the registers, the device-type field in the printed report is preceded 
by an asterisk (*). 

You make the error logging system aware of a new device-level module by adding a record 
to the DEVICE— INFO table in the DEVSMl module. A section of the table is reproduced in 
Table 4-5. 

Table 4-5: The DEVICE_INFO Table 



TABLE DEVICE -INFO; 



MNEMONIC 

PRINT-NAME 

ALT-PRINT-NAME 

DISP-NAME 

SIZE 

MASSBUS_FLAG 

DRIVE -TYPE 

BEGIN-TABLE 



ASCII [2] ; 
ASCII [6] ; 
ASCII [12] ; 
ASCII [6] ; 
LONGWORD ; 
LOGICAL ; 
BYTE ; 



! Device mnemonic 

! Name for printing 

! Alternate name for printing 

! Name of device module 

! Size of device 

! True if a MASSBUS device 

! MASSBUS device-type number 
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Table 4-5 (Cont.): The DEVICE-INFO Table 



'CT', 'TU60', 



'TU60', 



'ETAir, 



#LD'0', 



FALSE, 



#BO'0' ; 



'DB', 'RP04', 
'DB', 'RP05', 
'DB', 'RP06', 



'RP04/05', 'ERP456', 
'RP04/05', 'ERP456', 
'RP06', 'ERP456', 



#LD'171798', TRUE, #BO'20' 
#LD'171798', TRUE, #B0'21' 
#LD'340670', TRUE, #BO'22' 



'DD', 'TU58', 

'DP, 'RFir, 

'DK', 'RK05', 

'DL', 'RLOr, 
'DL', 'RL02', 

'DM', 'RK06', 
'DM', 'RK07', 
'DP', 'RP03', 

'DR', 'RM02', 
'DR', 'RM03', 
'DR', 'RM05', 
'DR', 'RMSO', 
'DR', 'RP07', 

'DS', 'RS03', 
'DS', 'RS03', 
'DS', 'RS04', 
'DS', 'RS04', 



'TU58', 



'RFll', 



'ETU58', 



'ERSll', 



#LD'512', 



#LD'-1', 



FALSE, 



FALSE, 



#BO'0' 



#BO'0' 



'RK03/05', 


'ERK05', 


#LD'480O', 


FALSE, 


#BO'0' 


'RLOl', 


'ERL12', 


#LD'10240', 


FALSE, 


#BO'0' 


'RL02', 


'ERL12', 


#LD'20480', 


FALSE, 


#BO'0' 


'RK06', 


'ERK67', 


#LD'27126', 


FALSE, 


#BO'0' 


'RK07', 


'ERK67', 


#LD'53790', 


FALSE, 


#BO'0' 


'RP03', 


'ERP23', 


#LD'80000', 


FALSE, 


#BO'0' 


'RM02/03', 


'ERM23', 


#LD'131680', 


TRUE, 


#BO'25 


'RM02/03', 


'ERM23', 


#LD'131680', 


TRUE, 


#BO'24 


'RM05', 


'RM05', 


#LD'500384', 


TRUE, 


#BO'27 


'RM80', 


'ERM80', 


#LD'242606', 


TRUE, 


#BO'26 


'RP07', 


'ERP07', 


#LD'1008000', 


TRUE, 


#BO'42 


'RS03/04', 


'ERS34', 


#LD'1024', 


TRUE, 


#BO'0' 


'RS03/04', 


'ERS34', 


#LD'1024', 


TRUE, 


#BO'l' 


'RS03/04', 


'ERS34', 


#LD'2048', 


TRUE, 


#B0'2' 


'RS03/04', 


'ERS34', 


#LD'2048', 


IKUE, 


#B0'3' 
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Table 4-5 (Cont.): The DEVICE_INFO Table 



'DT', 'TU56', 'TU56', 'ETCH', #LD'576', FALSE, #BO'0' ; 



The columns of the table, read from left to right, correspond to the declared items MNEMONIC, 
PRINT_NAME, ALT_PRINT_NAME, DISP_NAME, SIZE, MASSBUS_FLAG, and DRIVE- 
TYPE. The following descriptions explain each of these declared items: 

MNEMONIC 

The mnemonic is a 2-character ASCII field that is listed as the device mnemonic in the 
Device Control Block (DCB). Records should be kept in alphabetical order by mnemonic. 

PRINT_NAME 

This 6-character ASCII field identifies the particular device. This field is used in the printing 
of the Device Identification Information section of FULL or REGISTER reports whenever the 
device registers are available. Normally this field is used, unless devices are being mounted 
or dismounted. In such cases, the device registers are not available and, depending on the 
device, there may be insufficient information to completely identify a device. When this 
occurs, the ALT_PRINT_NAME field is used instead. 

ALT_PRINT_NAME 

This 12 -character ASCII field identifies the device when the device registers are not available, 
usually for mounts and dismounts. When this happens (depending on the device), there 
may be insufficient information to identify a device completely. For example, when an RP04 
is mounted, the only information available that can identify the device is the mnemonic DB 
and the device size. This information is the same for an RP04 and an RP05. In this case 
the ALT_PRINT_NAME field is used, which identifies the device as an RP04/05. 

DISP_NAME 

This 6-character ASCII field identifies the name of the device-level module used to process 
error logging entries for the particular device. 

SIZE 

This longword specifies the number of blocks on the device. There are two special values 
associated with this field, as follows: 

• A value of zero (0) indicates that the device is a magnetic tape. 

• A value of -1 indicates there is no fixed size for the device. DEVSMl will not correctly 
handle combinations of fixed- and variable-size devices having the same mnemonic. 

MASSBUS_FLAG 

This logical value indicates whether or not the device is a MASSBUS device. It is set to 
true for MASSBUS devices and false for any other devices. 
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DRIVE-TYPE 

This byte specifies the MASSBUS drive-type value. Each MASSBUS device has a unique 
value which is available in the low byte of the drive-tjrpe register. If the record is not for a 
MASSBUS device, this field should be zero (0). 

4.4.3 CPU-Level Dispatching 

CPU-level dispatching is performed by DSP5P1. The HEADER subpacket contains a variable 
called PROC_TYPE that indicates the t3^e of processor the error was logged on. DSP5P1 uses 
that variable to search a table that contains module names associated witfi the CPU-type value. 



4.5 Support of Non-DIGITAL Devices 

This section explains what you have to do to provide error logging support for non-DIGITAL 
devices. 

Adding error logging support for a non-DIGITAL device consists of either one or three of the 
following steps, depending on the desired level of support: 

1. The first step is to include error logging support in the driver. Without this support, no 
information can be logged for the device. For full error logging support, you must perform 
the follov«ng additional steps. 

2. Write a device-level module for the new device. 

3. Add the new module to the control file library and make the error logging system aware of 
the new module. 

4.5. 1 Error Logging of Unlcnown Devices 

The error logging system can handle entries from devices unknown to the system. Entries 
from an unknown device are handled by the EUNKWN module, which functions as a universal 
device-level module. For a brief report, EUNKWN will pass back the value N/A in the 
INTERMOD—DEVERR variables to indicate that the information is not available. For a full 
report, EUNKWN prints the device registers in a dump-style format where the bit-to-text 
translation would normally take place. The rest of the report is unchanged. 

4.5.2 Providing Driver Support for a Non-DiGITAL Device 

The Executive module ERROR contains the routines to be used by a driver to log device errors. 
A device error in this sense can be a real error, a timeout, or perhaps an informational message. 
The following sections discuss the routines in general. See the code in [11,10]ERROR.MAC for 
more detail. 

4.5.2.1 The $BIVISET Routine 

The $BMSET coroutine raises the processor priority to 7 (to lock out interrupts), sets the S2.ACT 
interrupt active bit in S.ST2 of the SCB, and then calls the caller to start the I/O function. When 
the re-called caller returns, $BMSET lowers the processor priority to 0, thus allowing interrupts 
once again. 



Error Log Control File Architecture 4-21 



Parameters 

Input 



R4 
Output 



SCB address 



The S2.ACT interrupt active bit is set. 

4.5.2.2 The $DVTMO and $DTOER Routines 

The $DVTMO routine logs device timeouts at PRO, and the $DTOER routine logs device 
timeouts at device priority. The routines behave identically except that $DTOER disables the 
device interrupt and lowers the processor priority to 0. 

The routines set S2.ACT, the interrupt active bit in the SCB word S.ST2. They then test to see 
if the timeout is a diagnostic function. Diagnostic functions are never logged. 

The routines load the error code and subcode in RO and the routine passes control to the 
$DVCER routine. 

Parameters 

Input 



R2 

R4 
R5 

Output 



= Address of a block of registers to log (must be the CSR address if KS.MBC is 
set) 

= SCB address 

= UCB address 



RO 
Rl 
C 



lE.DNR and 377 (Device not Ready) 
I/O packet address 

0, if not a diagnostic function. 

User response: Create an error log packet and fill it in. Put a pointer to the 
packet (S.BMSV) in the SCB and set the error in progress bit SP.EIP in S.PRI. 

1, if a diagnostic function. 

User response: Do not create an error log packet. 
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4.5.2.3 The $DVERR ($DVCER) Routine 

$DVERR and $DVCER are the same routine; $DVCER is the routine name, and $DVERR is a 
synonym. This routine logs device errors. If an error is already in progress on the device, it 
will be ignored. If not, $DVCER allocates an error log packet and fills it in with the context of 
the current transfer. Note that this routine requires that there be an I/O packet associated with 
this error. See Section 4.5.2.6 to log an error where there is no I/O active on the device. 

Note that the system also logs information about concurrent I/O activity on other devices. 

Parameters 
Input 

R2 = Address of a block of registers to log (must be the CSR address if KS.MBC is 

set) 

R4 = SCB address 

R5 = UCB address 

Output 

If no error is already in progress on this device, allocate an error log packet, fill it in, point 
the SCB to the packet, and set the error in progress bit. 

If an error is in progress on this device, this routine is a no-op. 

4.5.2.4 The $NSIER Routine 

The $NSIER routine logs nonsense interrupts. 

When you assign interrupt vectors for a device, you do not expect interrupts from the remaining, 
unused vectors. The $NSIER routine allows you to detect interrupts from unused vectors and 
log the errors as nonsense interrupts. 

Parameters 
Input 

@(SP) = Contains bits 06:04 of the unused vector number. 
Output 

If a nonsense interrupt is in the process of being logged, increment the interrupt count. 

If this is the beginning of the processing of a nonsense interrupt, identify the vector and 
create and queue an error log packet. 
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4.5.2.5 The $FNERL Routine 

The $FNERL routine is called at I/O completion or when it is necessary to queue an error log 
packet after a successful recovery of a mid-transfer error. This routine effectively completes the 
processing of an error. 

The routine first inserts the error retry information. It then tests to see if this was a hard 
(unrecoverable) error or a soft (recoverable) error and updates the packet accordingly. (All 
errors are assumed to be hard up to this point.) Depending on the result of that test, $FNERL 
tests against the appropriate limit to see if the limit has already been met. If the limit had been 
previously met, the packet is discarded. If not, $FNERL updates the appropriate error count, 
logs the packet, and sets the SCB to show that the processing of this error has been completed. 

Parameters 
Input 

RO = First I/O status word 

R2 = Starting and final error retry counts (if 0, do not update limits) 

R3 = Error log packet address (if R4 = 0) 

R4 = SCB address or 

R5 = UCB address 

Output 

Either queue or discard the error log packet (depending on the limits) and set the SCB to 
indicate that no error is being processed. 

4.5.2.6 The $LOGER Routine 

Drivers use the $LOGER routine to create an error log packet when no I/O is present, such 
as when a driver receives an unsolicited interrupt from a device that contains information that 
should be logged. $LOGER creates the packet normally, but the driver is responsible for filling 
in the DATA subpacket information. Otherwise, processing is similar to the $DVERR routine. 

Parameters 

Input 

Rl = Length of data to be logged (in bytes) 

R4 = SCB address (if 0, then no I/O packet is present) 

R5 = UCB address 
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Output 

C = 1; error cannot be logged for some reason 

C =0; error can be logged 

Rl = Address of DATA area in the packet 

R3 = Address of error log packet 

4.5.2.7 The LOGTST Routine 

The LOGTST routine is not for use by drivers. Other routines in the ERROR module call 
LOGTST to see if an error can or should be logged. 

4.5.2.8 The $CRPKT Routine 

The $CRPKT routine creates an error log packet. It is called as part of the $SMSG directive 
processing, and by other Executive routines as part of the processing of a memory error, 
nonsense interrupt, time change, powerfail recovery, or device error. 

The $CRPKT routine determines the required format and size of the packet, allocates the 
required amount of pool, and then fills in the packet. It obtains information from SYSCOM, 
the appropriate DCBs, UCBs, SCBs, TCBs, VCBs, and the I/O packet, as required. 

Note that a HEADER subpacket is always required. A forced system failure will result if 
$CRPKT detects the "no HEADER subpacket" condition. 

If a driver of an error logging device calls the $CRPKT routine to create an error logging packet, 
the data address for the data subpacket must not be an address within the driver. Specifically, 
the address must not be mapped by APR 5, as this APR is used to map the common. Any 
user-written driver that performs such a function must allocate a piece of pool, fill in the 
appropriate information, and pass the pool address to the $CRPKT routine. 

Note that information about concurrent I/O activity on other devices is always logged in 
addition to the activity on the device in question. 

Parameters 
Input 

RO = Packet code and subcode (see EPKDF for details) 

Rl = Length of DATA subpacket 

R2 = Control mask word (see EPKDF for details) 

R3 = Beginning address of data for DATA subpacket 

R4 = TCB address (for TASK subpacket) 

R5 = UCB address (for DEVICE_ID subpacket) 
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Output 

RO = Unchanged 

Rl = Beginning address of data in the DATA subpacket 

R2 = Unchanged 

R3 = Beginning address of error log packet 

R4 = Unchanged 

R5 = Unchanged 

C = if a packet was created 

C = 1 if a packet was not created 

4.5.2.9 The CALDEV Routine 

The CALDEV routine calculates the logical unit number for the given UCB. 



Parameters 




Input 




RO 


Pointer into the error log packet 


R3 


DCS address 


R5 


UCB address 



Output 

(RO) = Unit number stored in the error log packet at the byte (RO) 
RO = Updated to point to next byte in error log packet 

4.5.2.10 The $QUPKT Routine 

The $QUPKT routine queues an error log packet. If there is no other packet in the queue, 
$QUPKT requests the Error Logger task (ERRLOG) with a delay of 2 seconds. If there is another 
entry in the queue, $QUPKT requests ERRLOG to run immediately. Command packets from 
ELI always cause ERRLOG to run immediately. 

Parameters 
Input 

R3 = Pointer to packet for insertion in queue 
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Output 



None 

4.5.2. 1 1 The $QERMV Routine 

The $QERMV routine removes an entry from the error log queue and transfers it to a user 
buffer. It is called only by ERRLOG. 

Parameters 
Input 



R4 
R5 

Output 

Rl 

R4 

R5 

C 

C 



Length of user buffer 
Address of user buffer 



Length of packet (if Rl / 0) 

Unchanged 

Unchanged 

if packet was successfully removed 

1 if there was no packet to remove or packet was too long. If Rl ?^ 0, the 
packet was too long and Rl contains the packet length. If Rl = 0, then there 
was no packet to remove. 



4.6.3 Providing Error Logging Support for a Non-DIGITAL Device 

In addition to requiring that you correctly provide driver support, full error logging support for 
a non-DIGITAL device requires the following two extra steps: 

1. Write the device-level module for the new device. This module contains the detailed 
instructions on how to interpret the logged information; that is, the bit-to-text translation 
information for the device registers. The information common to all events is interpreted 
by the DIGITAL-supplied modules. 

2. Add the new module to the control file library and make the error logging system aware of 
the new module. 



Error Log Control File Architecture 4-27 



4.5.3.1 Writing a Device-Level iS/loduie 

This section explains the general structure of device-level modules, using the RM02/03 module 
ERM23 as an example. Section 4.6.1 is an annotated listing of ERM23 and Section 4.6.3 is an 
annotated listing of the notes module for the RM02/03 driver. Both the discussion here and 
the code in those two sections are keyed to each other by the module names (either ERM23 or 
DSP2P1) and numbers that look like this: O. 

You may wish to remove the pages for Sections 4.6.1 and 4.6.3 from your book for easier 
reference in following the interaction between these two modules. 

In general, the flow of a device-level module proceeds as follows: 

O MODULE statement followed by module header 

© PROCEDURE statement 

O SUBPACKET declaration 

O Register definitions 

® Declaration of local work variables and table declarations 

© Intermodule variable loading 

O Error-type determination 

© Coroutine back to caller 

© Bit-to-text translation and register printing 

® Note requirements indicated 

© Exit the module 

Each of these procedures is described in the following subsections. 

The MODULE Statement O 

The name of a user-written module must be in the following form: 

MODULE ExxUSR ident 

Generally, the module name begins with the letter E, followed by five or fewer letters indicating 
the device or devices served by the module. For example, the ERM23 module handles the 
RM02 and RM03 disks, while the ERP456 module serves the RP04, RP05, and RP06 disks. 

The letters xx are the 2-character device mnemonic. Your device mnemonic cannot be the same 
as any DIGITAL-supplied device mnemonic. 

The ident field is an identification value that is stored in the module. Usually, the ident begins 
with a letter that identifies the operating system the module is intended to be used with (such 
as P for RSX-llM-PLUS), followed by a version and update number in the standard DIGITAL 
style. 

The module header follows. This includes the copyright statement, author, date written, and 
audit trails of modifications. 
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The PROCEDURE Statement O 

The PROCEDURE statement for a user-written module must be in the following form: 

PROCEDURE DEVICE_ENTRY 

The procedure name must be DEVICE-ENTRY. This name is hard-coded into the DSP2P1 and 
DSP3P1 dispatcher modules. 

Ttie SUBPACKET Declaration O 

The device-level module is responsible for the declaration of the device data (usually in the 
form of registers). The SUBPACKET declaration defines the number of registers, how they are 
printed, and the bit-to-text translations for the various bits and fields of the registers. 

The following code example is a segment of the ERM23 device-level module for the RM02/03 
disk drives: 

SUBPACKET subpacket.name = DISP . NEXT.PACKET NAMED ; 

reg_naiiie: WORD MACHINE ; 

BIT [15]: 'true.text' ; 

BIT [14]: 'true.text' , 

'false.text' ; 

aux_label: FIELD [12:2]: 'Bits 12 and 13 = ' 

I y.CNV_$BINARY(Subpacket_naiiie.aux_label. 2. '0') 
I ' (B)' ; 
BIT [11]: 'true.text' ; 



reg_iiame: WORD mCHINE ; 

END_PACKET ; 

The following comments explain some of the key elements in the preceding example: 

• The subpacket name is usually REGISTER, although this name is not required. 

• DISP.NEXT-PACKET is a variable that contains the subpacket number of the data subpacket 
and has been set up by the preceding modules. 

• The NAMED qualifier indicates to RPT that the register labels are to be saved for later 
printing. 

• Following the SUBPACKET declaration are the definitions of the registers and their bits and 
fields. 

• The statement END—PACKET indicates the end of the subpacket declaration. 
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Register Definitions O 

The label assigned to a register provides both a reference to the register (a variable name) and 
a name for the register when printing. The register name is printed later on (if you specified a 
full format report). In most cases, the error logging system uses the same register names used 
by DIGITAL Field Service hardware documents. 

For the RM02/03 device-level module, the first register declared loolcs like the following: 



'♦Special Condition set' ; 

'♦Transfer Error' ; 

'♦MASSBUS Control Bus Parity Err' ; 

'♦Unused bit set' ; 

' Drive Available' , 

'♦Drive not Available (other port using it)' 

' UNIBUS B Selected for Data Transfer', 

' UNIBUS A Selected for Data Transfer' ; 



RMCSl 




WORE 


» MACHINE 






BIT 


[15]: 


RMCSl. 


.TRE: 


BIT 


[14]: 






BIT 


[13]: 






BIT 


[12]: 






BIT 


[11]: 



BIT [10] ; 



RMCS1_BA: 


FIKT.n [8:2] 




BIT [ 7] : 




BIT [ 6] : 



' BA17,BA16 = ' 

I %CNV_$BINARY (REGISTER. RMCSl BA, 2. 

I ' (B)' : 

' Controller Ready', 

' Controller not Ready' ; 

' Interrupt Enabled' , 

' Interrupt not Enabled' ; 



'0') 



The following comments explain some of the key elements in the preceding example: 

• The first line indicates that the name of the register is RMCSl and that it is a word (16 
bits) in length. 

• The MACHINE qualifier states that, when printed, the register is to be formatted in the 
native radix for the machine that the report is being generated on. The native radix for 
a PDP-11 processor is octal, and for a VAX processor, hexadecimal. Other print qualifiers 
are available to change the radix, such as HEX, OCTAL, DECIMAL, BCD, BINARY, and 
RAD50. 

• The second line defines bit 15 of the register RMCSl, including when it is to be printed 
and what is to be printed. Only one text string is provided. This indicates that the bit is to 
be printed only when set to true. Otherwise, nothing is printed for that bit. 

• Bit 14 has the label RMCS1_TRE. Labels assigned to bits and fields are never printed. They 
are allowed so you can reference the bit or field as a variable. As with bit 15, the text for 
this bit is printed only if the bit is set to true. 

• Bit 11 has two text arguments. The first argument is printed if the bit is set and the second 
argument is printed if the bit is reset. In other words, this bit will always be printed. 

• Bits 8 and 9 are defined to be a FIELD with the variable name RMCS1_BA. The general 
format for a field definition is as follows: 
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FIELD [8tarting_bit_number:nuiiiber_of_bit8] : ' other_8tring ' . 

'O.string' . 
'l_string' , 
'2_string' , 



'N_8tring' ; 

• In the field definition, the 0— string is printed if the value of the field is 0. The l_string is 
printed if the value of the field is 1, and so on. The other_string is printed if the field has 
a value that has no corresponding text string. Note that for the field RMCS1_BA there is 
only an other_string. Therefore, this field is always printed. 

A technique that is used in the DIGITAL device-level modules is to declare a field over 
any contiguous unused bits. The other_string is defined to be 'Unused bits set', and the 
0_string is defined to be null (the null, or zero_length, string). If the field has the value 0, 
nothing is printed. If, however, any of the bits are set, the field appears in the report. 

Note that all of the text strings associated with bits and fields have as their first character 
either a space or an asterisk. When printing the text for a bit or field, RPT removes the first 
character of the string and places it in front of the bit or field position indicator. An asterisk 
signals some kind of special condition. For example, bit 11 of RMCSl can print one of the 
following ways: 

[11] Drive Available 

*[11] Drive not Available (other port using it) 

Remember that the asterisk does not necessarily indicate an error, just something interesting. 
A blank in front of the position indicator means a normal or status condition. 

• You can use IF...THEN...ELSE, CASE, and SELECT statements to conditionalize the 
declaration of the subpacket. The statement blocks in these structures must be enclosed 
by BEGIN and END. You can use variables previously declared in the subpacket even 
though the declaration of the subpacket is not complete. Also note the use of the %LOK 
(look-ahead) functions in various device-level modules. They look into a subpacket before 
it is declared, usually to produce variables to control the declaration. 

• Note the variable REGISTER.LENGTH towards the end of the subpacket declaration in 
ERM23. This variable was created when the SUBPACKET statement was executed. The 
variable name is of the form subpacket_name.LENGTH and contains the number of bytes 
in the subpacket. 

Declaration of Local Work Variables and Tables O 

The device-level module often needs some local variables and tables. These are usually defined 
after the end of the subpacket declaration, although this is not required. However, remember 
that variables must be declared in a module before they can be used. 

If the device specified in your module is a disk, you must set the INDICATE. TAPE _FLAG to 
false. If the device is not a disk, set the INDICATE.TAPE_FLAG to b^ie. 
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Loading of the Intermodule Variables O 

The DISPATCH module declares a collection of variables having the group name INTERMOD_ 
DEVERR. Some of these ASCII string variables pass information from the device-level modules 
back to their caller. The variables that must be filled in are as foUowrs: 

INTERMOD_DEVERR.DRIVE_SN 

INTERM0D_DEVERR.DEV_FUNCT10N 

INTERMOD_DEVERR.PHYS_UNIT 

INTERMOD_DEVERR.ERROR_CYLINDER 

INTERMOD_DEVERR.ERROR_SECTOR 

INTERMOD_DEVERR.ERROR_HEAD 

lNTERMOD_DEVERR.ERROR_GROUP 

INTERMOD_DEVERR.BLOCK_NUMBER 

INTERMOD_DEVERR.ERROR_TYPE 

INTERMOD_DEVERR.DRIVE_TYPE (see Section 4.5.3.3 for more details on this variable) 

This section of the module is where these variables are filled in. Use the string N/A if the 
information is either not applicable or not available. Note that for certain devices, most notably 
magnetic tapes, the ERROR-CYLINDER variable is filled in with the ??? string. This flag tells 
the dispatcher module to suppress the printing of the section entitled Device Error Position 
Information. Note that one of the variables to be filled in contains the error type. See the 
following subsection for more details on how the error type is determined. 

Determination of the Error Type O 

The error-type definition is a determination of the most likely problem as indicated by the error 
bits for a given event. It is not a determination of what failed, but rather an indication of what 
events occurred that could be associated with the failure. The error type is determined solely 
on the basis of the bits in the current event; no interevent analysis is performed. 

The error type is determined by a precedence parse of the various error bits found in the device 
registers. The DECODE statement, in conjunction with IF...THEN...ELSE-type constructs, is 
used to search the bits in a specific order. The first condition found to be true stops the search. 

Coroutine Back to Caller O 

Once all the intermodule variables have been filled in, a coroutine statement returns control 
to the device module's caller. The caller examines the returned information and determines 
whether to continue processing the event. Nothing has been printed up to this point in the 
processing of this event. 

If the decision is not to proceed, but to reject the event, the caller (a) sets the INTERMOD— 
DEVERR.PRINT_FLAG variable to false, and (b) returns control, through a coroutine statement, 
to the device-level module. 
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If the decision is to proceed, the caller performs some or all of the printing, depending on 
whether the print format is FULL or BRIEF. If the FULL format is specified, the caller (a) prints 
everything except the device registers, (b) sets the INTERMOD_DEVERR.PRINT_FLAG variable 
to true, and (c) returns control, through a coroutine statement, to the device-level module. If 
the format is brief, the caller (a) performs all required printing, (b) sets the INTERMOD- 
DEVERR.PRINT_FLAG variable to false, and (c) returns control, through a coroutine statement, 
to the device-level module. 

When the device-level module regains control, it examines the print flag. If the flag is set to 
true, the module prints the device registers and generates any required note indicators. If the 
print flag is false, the module exits. 

Perform the Bit-to-Text Translation and Register Printing ® 

If the INTERMOD_DEVERR.PRINT_FLAG variable is true, the device-level module prints the 
device registers and performs the required bit-to-text translation. This is done by executing 
a WRITE statement (to produce column headers) followed by a WRITE -GROUP statement. 
The WRITE-GROUP statement references the subpacket name specified in the SUBPACKET 
statement. It also uses two variables, REPORT. W_G_F_1 and REPORT.W_G_F_2, as format 
strings. These variables are initialized by the INITMl module and contain the format strings 
for printing the register data in either wide or narrow format. If you need to print data that 
does not conform to the formats defined by these variables, you can define your own format. 
You can test the logical variable REPORT.WIDE to determine whether a wide or narrow report 
was requested. 
If the INTERMOD_DEVERR.PRlNT_FLAG variable is false, the device-level module exits. 

Indicate Any Notes Ttiat Are Required (E) 

The error logging system can print notes for certain conditions that need additional explanation. 
If you need such notes, you can create a notes module (see Section 4.5.3.2 for details) and 
include it in the library. You can then request a note by referencing it from the device-level 
module. 

You request a note by inserting a PUT statement in the NOTE-NUMBERS file that specifies the 
note number in the NOTE_NUMBERS.INDEX variable. For example, the RM02/03 device-level 
module can optionally generate a note if certain unused bits in the RMDA register are set. This 
is done by using the following code: 

! If the unused bits 5 to 7 are set in the RMDA register. 

! 

IF (REGISTER. RMDA [5:3] NE #BB'0') 

THEN 

Print the note saying that it may cause an invalid 
sector address to be recognized resulting in a 
possible invalid address error. 

PUT NOTE_NUMBERS INDEX = 1 ; 
END.IF ; 
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When the device-level module exits, the caller tests to see whether any notes were requested. 
If notes were requested, the dispatcher strips the first character from the device-level module's 
name and replaces it with the letter N. For example, the notes module for ERM23 (the RM02/03 
device-level module) is NRM23. The dispatcher calls the notes module, sdiich determines which 
notes were requested and prints them. 

Multiple notes can be requested. They are printed in the order requested. 
Exit the Module <D 

When everything is done, the device-level module exits. Exiting a module implies a RETURN 
instruction to the module's caller. Exiting from a device-level module also breaks the coroutine 
relationship. 

4.5.3.2 Writing a Notes iVIodule 

This section explains the structure of a notes module using the RM02/03 notes module as an 
example. Section 4.6.3 contains an annotated listing of this module. 

The general flow of a notes module is as follows: 

O MODULE statement followed by module header 

e PROCEDURE statement 

® Notes heading 

O Selection of a note for printing 

© Handling of an unknown note number 

© Getting the next note 

© Exit the module 

Ttie MODULE Statement © 

The MODULE statement for a notes module must be in the following form: 
MODULE NxxUSR ident 

The module name of a notes module is related to its corresponding device-level module name 
by replacing the first letter of the device-level module's name with the letter N to get the notes 
module name. This convention must be followed because the notes module name is derived 
from the name of the device-level module and is never looked up in a table. 

See Section 4.5.3.1 for an explanation of the ident field of the MODULE statement. 

Ttie PROCEDURE Statement © 

The PROCEDURE statement for a notes module must be in the following form: 
PROCEDURE NOTES 

The procedure name must be NOTES. This is coded into the DSP2P1 and DSP3P1 dispatcher 
modules. 
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The Notes Heading O 

The notes heading declares what is about to be printed. Notice that notes appear directly 
following the register interpretation in FULL and REGISTER reports only. 

Selecting a Note for Printing O 

Notes are selected for printing by teshng the NOTE —NUMBERS file for context after performing 
a POINTER NOTE -NUMBERS FIRST operation. If records remain (that is, if there is context), 
a SELECT statement is performed on the variable NOTE-NUMBERS.INDEX. This variable 
indicates which note to print. 

Handling an Unknown Note Number O 

The ELSE clause of the SELECT statement traps unknown note numbers. A SIGNAL operation 
is performed using the UNKNWNNOT error indication. The note number and the drive type 
are passed to the error handler as string arguments. 

Getting ttie Next Note O 

The next note is obtained by POINTER NOTE -NUMBERS NEXT. This causes RPT to point to 
the next record in the NOTE-NUMBERS file. If another record exists, the NOTE-NUMBERS 
file has context at the top of the WHILE. ..DO loop. If no other record exists, there will be no 
context; hence, there will be no more notes. 

Exit the Module O 

When everything is done, the notes module exits. Exiting a module implies a RETURN 
instruction to the module's caller. 

4.5.3.3 MASSBUS and Non-MASSBUS Device Considerations 

All device-level modules work essentially the same way; the only exception is that MASSBUS 
modules are not required to fill in the INTERMOD_DEVERR.DRIVE-TYPE variable, whereas 
non-MASSBUS modules must fill in this variable. 

This requirement has to do with mixed MASSBUS configurations. With mixed configurations, 
the Executive's database may not match the actual configurations if unit plugs have been 
inadvertently swapped. 

To avoid unwanted results in case of such a mismatch, the error logging system performs the 
following operations: 

1. When a device's mnemonic is found in the DEVICE— INFO table in module DEVSMl, the 
MASSBUS— FLAG is checked. If it is true, a look-ahead into the device registers returns the 
device's DRIVE-TYPE. 

2. The DEVICE— INFO table is then searched again to find a record having that drive type. 

3. The error logging system then dispatches to the module corresponding to the actual registers 
logged, rather than dispatching to the module indicated by the mnemonic provided in the 
Executive. 
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For MASSBUS devices, the error logging system uses the device name provided by the DEVICE— 
INFO table. This name v^dll always be correct, since each MASSBUS device has a unique drive- 
type value. If there is a mismatch between the mnemonic supplied and the device type as 
determined by examining the registers, the device-type field in the printed report is preceded 
by an asterisk. 

It is the device-level module's responsibility to supply correct drive-type information for non- 
MASSBUS devices. The DEVSMl module fills in the value based on the device's mnemonic 
and size, but sometimes this information is not accurate. The RK03 and RK05 are examples of 
where this is necessary. Both RK03 and RK05 device errors are processed by the ERK05 module. 
The ERK05 module identifies the drive type by its device registers, and fills in the DRIVE —TYPE 
variable accordingly. Another example of where the correct drive-type information is necessary 
is DU devices, where the error logging system is only concerned that the device mnemonic be 
DU. It is up to the modules that handle these devices to provide the drive-t5rpe information. 

4.6 Code Examples 

This section provides examples of source code from the error logging system. These examples 
are annotated for use with previous sections of this chapter. They are written in the Control 
File Language (CFL), which is documented in Chapter 5. The examples in this chapter are as 
follows: 

• The ERM23 device-level module for RM02 and RM03 drivers 

• The DSP2P1 dispatcher module 

• The NRM23 notes module for RM02 and RM03 drivers 

4.6. 1 The RM02/03 Device-Level Module ERM23 

The following example is an annotated listing of ERM23.MAC, the device-level module for the 
RM02 and RM03 disk drives: 



MODULE ERM23 "MOl.Ol' ; 

ERROR LOG CONTROL FILE MODULE: RM02. RM03 

COPYRIGHT (c) 1981 BY 

DIGITAL EQUIPMENT CORPORATION. MAYNARD 

MASSACHUSETTS. ALL RIGHTS RESERVED. 

THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED 
AND COPIED ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE 
AND WITH THE INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS 
SOFTWARE, OR ANY OTHER COPIES THEREOF, MAY NOT BE PROVIDED OR 
OTHERWISE MADE AVAILABLE TO ANY OTHER PERSON. NO TITLE TO AND 
OWNERSHIP OF THE SOFTWARE IS HEREBY TRANSFERRED. 
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THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT 
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL 
EQUIPMENT CORPORATION. 

DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF 
ITS SOFTWARE ON EQUIPMENT THAT IS NOT SUPPLIED BY DIGITAL. 

VERSION 01.01 

ROBERT E. LI 08-JAN-81 

This is one of the many device modules, which is called by the device 
error dispatcher (DSP2Pi) or device information dispatcher (DSP3P1) 
to process all the device dependent information. 

Modified by: 

CBP Correct BAE/CS3 register logic 



PROCEDURE DEVICE.ENTRY 

This procedure, which is called via a COROUTINE statement from a dispatch 
module, declares and translates all device registers or data fields of 
the data subpacket. The intermodule variables required by the dispatch 
modules are stuffed with the appropriate values, followed by a COROUTINE 
back to the dispatch module. The dispatch module then COROUTINES back to 
this routine a second time, at a point where a write group is used to 
print the details of a FULL or REGISTER report. 

! 
BEGIN 

Declare a variable to hold the length of the subpacket. 

DECLARE PACKET.LENGTH ; 

TEMP :BYTE ; 

END_DECLARE ; 

! Now get the length of the DATA subpacket. Remember that the returned value 

! is in bytes and includes two bytes for the length word. 

! 

SET PACKET_LENGTH.TEMP TO y.LOK_$LENGTH(DISP.NEXT_PACKET) ; 

Define the data subpacket offsets and all the print information. 



SUBPACKET REGISTER = DISP . NEXT.PACKET NAMED 
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RMCSl: WORD MACHINE 

BIT [15]: 

RMCSl.TRE: BIT [14]: 
BIT [13] : 
BIT [12]: 
BIT [11]: 

BIT [10]: 



'♦Special Condition set' ; 

'♦Transfer Error' ; 

'♦MASSBUS Control Bus Parity Err' ; 

'♦Unused bit set' ; 

' Drive Available', 

'♦Drive not Available (other port using it)' 

' Unibua B Selected for Data Transfer ' . 

' Unibus A Selected for Data Transfer' ; 



RMCSl.BA: FIELD [8:2]: 





BIT [ 7] : 




BIT [ 6] : 


RMCSl.FN: 


FIELD [1:5] : 


RMWC: 


BIT [ 0] : 
WORD MACHINE 




FIELD [0:16] 


RM6A: 


WORD MACHINE 
FIELD [0:16] 


RMDA: 
RMDA_HD: 


WORD MACHINE 
FIELD [13:3] 
FIELD [8:5]: 



FIELD [5:3] : 
RMDA.SEC: FIELD [0:5]: 

RMCS2: 



RMCS2_WC : 



WORD MACHINE 

BIT [15]: 

BIT [14]: 

BIT [13]: 

BIT [12]: 

BIT [11]: 

BIT [10] 

BIT [ 9] 

BIT [ 8] 

BIT [ 7] 

BIT [ 6] : 

BIT [ 5] : 

BIT [ 4] : 

BIT [ 3] : 
RMCS2_UN: FIELD [0:3]: 



' BA17,BA16 = ' 

I XCNV_$BINARY (REGISTER. RMCSl.BA, 2, '0') 

I ' (B)' ; 

' Controller Ready ' . 

' Controller not Ready' ; 

' Interrupt Enabled', 

' Interrupt not Enabled' ; 

' Function = ' 

I INTERMOD_DEVERR.DEV_FUNCTION ; 

'♦Go bit on' ; 

7.CNV_$DECIMAL_P (XC0M_$NEGATE (REGISTER . RMWC) , 6) 
I ' words remaining' ; 

' Bub Address Register' ; 

'♦Unused bits set', NULL ; 

' Track Address = ' 

I '/.CNV_$DECIMAL_P (REGISTER. RMDA_HD. 2) ; 

'♦Unused bits set (see note)', NULL ; 

' Sector Address = ' 

I y,CNV_$DECIMAL_P (REGISTER. RMDA.SEC, 2) ; 

'♦Data Late' ; 
'♦Write Check Error' ; 
' ♦Parity Error ' ; 
'♦Nonexistent Drive' ; 
'♦Nonexistent Memory' ; 

'♦Program Error' ; 

'♦Missed Transfer' ; 

'♦MASSBUS Data Bus Parity Error' ; 

' Output Ready (silo contains data) ' , 

' Output not Ready (silo empty) ' ; 

' Input Ready (silo not full) ' , 

' Input not Ready (silo full) ' ; 

' Controller Clear ' 

I ' (clears all drives as well) ' ; 

'♦Parity Test set (even parity)', 

' Parity Test reset (odd parity) ' ; 

'♦Bus Address Increment Inhibit' ; 

' Drive Selected = ' 

I INTERMOD_DEVERR.PHYS_UNIT ; 



4r-38 Error Log Control File Architecture 



HMDS: 


WORD 


MACHINE 




BIT 


[15]: 


RMDS_ERR : 


BIT 


[14]: 




BIT 


[13]: 




BIT 


[12]: 




BIT 


[11]: 




BIT 


[10]: 




BIT 


[ 9]: 




BIT 


[ 8]: 




BIT 


[ 7]: 




BIT 


[ 6]: 




FIELD [1:5]: 




BIT 


[ 0]: 


RMERl: 


WORE 


MACHINE 


RMERl.DCK: 


BIT 


[15]: 




BIT 


[14]: 




BIT 


[13]: 




BIT 


[12]: 




BIT 


[11]: 




BIT 


[10]: 




BIT 


[ 9]: 




BIT 


[ 8]: 




BIT 


[ 7]: 


RMERl.ECH 


BIT 


[ 6]: 




BIT 


[ 5]: 




BIT 


[ 4]: 




BIT 


[ 3]: 




BIT 


[ 2]: 




BIT 


[ 1]: 




BIT 


[ 0]: 


RMAS: 


WORD MACHINE 




FIELD [8:8]: 




BIT 


[ 7] : 




BIT 


[ 6]: 




BIT 


[ 5]: 




BIT 


[ 4]: 




BIT 


[ 3]: 




BIT 


[ 2]: 




BIT 


[ 1]: 




BIT 


[ 0]: 


RMLA: 


WORD MACHINE 




FIELD [11:5] 


RMLA.ANG: 


FIELD [6:5]: 



FIELD [0:6]: 



' Attention Active' ; 

'♦Error (RMERl, 2 have bits set)' ; 

' Position in Progress' ; 

' Medium Online ' , ' *Medium not Online ' ; 

' Drive is Write Locked', 

' Drive is Write Enabled' ; 

' Last Sector Transferred (last of the pack) ' 

' Programmable (ports program selectable) ' ; 

' Drive Present', ' *Drive not Present' ; 

' Drive Ready' , 

' Drive not Ready' ; 

' Volume Valid ' , ' *Volume not Valid ' ; 

' *Unu8ed bits set ' , NULL ; 

' Drive in Offset Mode' , 

' Drive not in Offset Mode' ; 



'♦Data Check' ; 
'♦Drive Unsafe' ; 
'♦Operation Incomplete' ; 
'♦Drive Timing Error' ; 
'♦Write Lock Error' ; 

'♦Invalid Address Error' ; 
'♦Address Overflow Error' ; 
'♦Header CRC Error' ; 
'♦Header Compaire Error' ; 

'♦ECC Hard Error' ; 
'♦Write Clock Fail' ; 
'♦Format Error' ; 
'♦Parity Error' ; 

'♦Register Modification Refused' 
'♦Illegal Register' ; 
'♦Illegal Function' ; 



y.CND_$IF (REGISTER. RMDT [11], 

NULL, '♦Unused bits set'), 
NULL ; 

' Unit #7 Attention' 
' Unit #6 Attention' 

' Unit #5 Attention' 
' Unit #4 Attention' 
* Unit #3 Attention' 

' Unit #2 Attention' 
' Unit #1 Attention' 
' Unit #0 Attention' 

'♦Unused bits set', NULL ; 

' Sector Count = ' 

I 7.CNV_$DECIMAL_P (REGISTER. RMLA.ANG, 2) 

'♦Unused bits set', NULL ; 
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RMD6: 



WORD MACHINE 
FIELD [0 : 16] : 



Data Buffer contents' 



RMMRl: WORD MACHINE ; 
BIT [15]: 



BIT [14] : 



BIT [13] : 
BIT [12]: 
BIT [11]: 
BIT [10] : 
BIT [ 9]: 

BIT [ 8] : 

BIT [ 7] : 
BIT [ 6] : 
BIT [ 5] : 



BIT [ 4] : 
BIT [ 3] : 



y.CND_$IF (REGISTER .RMMRl.MM . 
' Debug Clock set ' . NULL) . 

%CND_$IF (REGISTER . RMMRl.MM . 

' Debug Clock reset • . NULL) ; 
■/.CND_$IF (REGISTER . RMMR1_MM , 

' Debug Clock Enabled'. NULL), 
y.CND_$IF (REGISTER . RMMRl.MM , 

' Debug Clock Disabled', NULL) ; 

XCND_$IF (REGISTER . RMMRl.MM , 

' Diagnostic End of Block set', NULL), 
XCND_$IF (REGISTER . RMMRl.MM . 

' Diagnostic End of Block reset '.NULL) ; 

XCND_$IF (REGISTER . RMMR1_MM . 

' Search Time Out disabled' . NULL) , 
7.CND_$IF (REGISTER . RMMRl.MM , 

' Search Time Out enabled'. NULL) ; 

XCND_$IF (REGISTER . RMMRl.MM . 

' Maintenance Clock set ' . NULL) . 
%CND_$IF (REGISTER . RMMRl.MM . 

' Maintenance Clock reset'. NULL) ; 

'/tCND_$IF (REGISTER . RMMRl.MM . 

' Maintenance Read Data set ' . NULL) . 
XCND_$IF (REGISTER . RMMRl.MM . 

' Maintenance Read Data reset '.NULL) ; 

XCND_$IF (REGISTER . RMMR1_MM , 

' Maintenance Unit Ready', NULL). 

XCND_$IF (REGISTER . RMMRl.MM , 

' Maintenance Unit Not Ready ' . NULL) ; 

XCND_$IF (REGISTER . RMMRl.MM . 

' Maintenance On Cylinder'. NULL). 
XCND_$IF (REGISTER . RMMR1_MM , 

' Maintenance not On Cylinder ', NULL) ; 
XCND_$IF (REGISTER . RMMR1_MM . 

' *Maintenance Seek Error ' . NULL) ; 
XCND_$IF (REGISTER . RMMR1_MM . 

'♦Maintenance Drive Fault '.NULL) ; 

XCND_$IF (REGISTER . RMMRl.MM . 

' Maintenance Sector Pulse set ' , NULL) . 
XCND_$IF (REGISTER . RMMRl.MM . 

' Maintenance Sector Pulse reset ' . NULL) 

'♦Unused bit set' ; 
XCND_$IF (REGISTER . RMMRl.MM . 

' Maintenance Write Protect ' . NULL) , 
XCND_$IF (REGISTER . RMMR1_MM . 

' Maintenance Write Enabled'. NULL) ; 
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BIT [ 2]: 



BIT [ 1] : 



RMMR1_MM: BIT [ 0]: 



7,CND_$IF (REGISTER . RMMRl.MM , 

' Maintenance Index Pulse set ' , NULL) , 
XCND_$IF (REGISTER . RMMRl.MM , 

' Maintenance Index Pulse reset', NULL) ; 

%CND_$IF (REGISTER . RMMR1_MM . 

' Maintenance Sector Compare set ' , NULL) , 

7.CND_$IF (REGISTER . RMMRl.MM , 

' Maintenance Sector Compare reset ' , NULL) ; 
' Diagnostic Mode on' , 
' Diagnostic Mode off ; 



RMDT: WORD MACHINE 
BIT [15] 
BIT [14] 
BIT [13] 

BIT [12]: 
BIT [11]: 

FIELD [9:2] : 
RMDT.TYP: FIELD [0:8]: 



'■i<Drive not Sector Addressable' ; 

■*Unit is a Tape Drive' ; 

NULL, '*Unit is not a Moving Head Device' 

'♦Unused bit set' ; 

' DRQ on (dual port unit) ' , 

' DRQ off (single port unit) ' : 

' ^Unused bits set ' , NULL ; 

' Drive Type = ' 

I INTERMOD_DEVERR.DRIVE_TYPE ; 



RMSJ 


f: 


WORD MACHINE 
FIELD [0:16] 


RMOF: 


WORD MACHINE 
FIELD [13:3] 
BIT [12] : 




BIT [11] : 
BIT [10] : 




FIELD [8:2]: 
BIT [ 7] : 


■: 


FIELD [0:7]: 


RMDC: 
RMDC_DC: 


WORD MACHINE 
FIELD [10:6] 
FIELD [0:10] 


RMHR: 


WORD MACHINE 
FIELD [0:16] 


RMMI 


12: 


WORD MACf 
BIT [15] 
BIT [14] 
BIT [13] 
BIT [12] 


IIHE 



Drive Serial Number = ' 

XCNV_$BCD (REGISTER. RMSN, 4) I ' (BCD)' 



'♦Unused bits set', NULL ; 
' 16 Bit Data Format ' , 
'*18 Bit Data Format' ; 

' ECC Inhibit', ' ECC enabled' 
' Header Compare Inhibit' , 
' Header Compare Enabled' ; 

'♦Unused bits set', NULL ; 

' Offset Direction = Forward' , 

' Offset Direction = Reverse' 

'♦Unused bits set', NULL ; 



• ♦Unused bits set ' , NULL ; 

' Desired Cylinder = ' 

I %CNV_$DECIMAL_P (REGISTER. RMDC.DC, 4) 



' Holding Register contents' ; 

' Port A Request for Service' ; 

' Port B Request for Service' ; 

' Control Select Tag on' ; 

y,CND_$IF (REGISTER . RMMRl.MM , 

' Test Sequencer Branching on' , NULL) 
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BIT [11]: 
BIT [10] : 

RMMR2_MBL: FIELD [0:10]; 



' Control or Cylinder Tag on' ; 

' Control or Head Tag on' ; 

7.CND_$IF (REGISTER . RMNRl.MM , 

' Maintenance Bus Lines = ' 

I XCNV_$BINARY (REGISTER. RMMR2_MBL, 10. 

I ■ (B)' 

, NULL) ; 



'0') 



RMER2: 



WORD MACHINE 
BIT [15] : 
BIT [14] : 
BIT [13] : 
BIT [12] : 



BIT [11] 
BIT [10] 
FIELD [8 
BIT [ 7] 

FIELD [4 
BIT [ 3] 
FIELD [0 



2]: 

3]: 
3]: 



' *Bad Sector Detected (hdr bit) ' 
'*Seek Incomplete' ; 
' *Operator Plug Error (removed) ' ; 
'♦Invalid Command (W bit reset)' 

'♦Loss of System Clock' ; 
''•'Loss of Bit Clock' ; 
'♦Unused bits set'. NULL ; 
'♦Device (%eck' ; 

'♦Unused bits set'. NULL ; 
'♦Data Parity Error' ; 
'♦Unused bits set', NULL ; 



RMECl : 



WORD MACHINE 
FIELD [13:3]: 



RMECl.PS: FIELD [0:13] 



'♦Unused bits set'. NULL ; 

' ECC Position = • I VAR.ECCPS 



RMEC2: 



WORD MACHINE ; 
FIELD [11:5] : 
FIELD [0:11] : 



'♦Unused bits set' 
' ECC Pattern = ' 



NULL ; 
I VAR.ECCPAT 



IF DEVICE_OP.FLG_BAE AND (PACKET_LENGTH . TEMP EQ #BD'46') 

If the RH70 flag is true and the packet length is 22 registers, 
declare the BAE and CSS registers. Note that the packet length check 
is necessary because unmapped RSX systems will not log BAE and CSS 
even if the controller is an RH70. 



THEN 

BEGIN 

RMBAE: 



WORD MACHINE 
FIELD [6 : 10] : 
RMBAE_EXT: FIELD [0:6]: 



RMCSS: 



WORD MACHINE 
BIT [15] 
BIT [14] 

BIT [13] 

BIT [12] 

BIT [11] 

BIT [10] 

FIELD [7:3]: 
BIT [ 6] : 

FIELD [4:2]: 



'♦Unused bits set'. NULL ; 

' BA21 through BA16 = ' 

I 7.CNV_$BINARY(REGISTER.RMBAE_EXT, 6. 

'♦Address Parity Error' ; 
'♦Data Parity Error. Odd Word' ; 

'♦Data Parity Error. Even Word' ; 
'♦Write Check Error. Odd Word' ; 
'♦Write Check Error. Even Word' ; 
' Double Word Transferred' ; 

'♦Unused bits set'. NULL ; 
' Interrupt Enabled ' , 

' Interrupt not Enabled' ; 

• ♦Unused bits set ' . NULL ; 



'0') 
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RMCS3_IPC : FIELD [0:4]: 



' Inverse Parity Check Bits = ' 

I '/.CNV_$BINARY (REGISTER. RMCS3_IPC. 4, 

I ' (B)' ; 



END ; 
END. IF 
END.PACKET 



'0') 



Declare all variables needed for the subpacket print information. 



DECLARE VAR 
ECCPS : 
ECCPAT: 

END_DECLARE 



ASCII 
ASCII 



[22] 
[22] 



! ECC position. 
! ECC pattern. 



Create the device function code conversion table. 



TABLE FUNCTION 
FUN_CODE: 
FUN_TEXT : 

BEGIN.TABLE 
#B0'OO'. 

«B0'02 
«B0'O3 
#B0'O4 
«B0'O5 
#B0'O6 

#B0'07 
«B0 ■ 10 
#BO'il 
#B0'14 
#B0'24 

«B0'25 
#B0'3O 
#BQ'31 
«B0 ■ 34 
#B0 ■ 35 
END.TABLE 



BYTE MACHINE ; 
ASCII [27] ; 

'No Operation' ; 

'Seek Coounand' ; 
'Recalibrate' ; 
'Drive Clear' ; 
'Release (dual port)' ; 
'Offset Command' ; 

'Return to Centerline' ; 
'Read_in Preset' ; 
'Pack Acknowledge' ; 
'Search Command' ; 
'Write Check Data' ; 

'Write Check Header and Data' 

■Write Data" ; 

'Write Header and Data' ; 

'Read Data' ; 

'Read Header and Data' : 



Calculate the ECC Position. 

Determine if the ECC position is normal (not used) , has an illegal 
value, points to the starting bit within the sector or is irrelevant. 

IF REGISTER. RMEC1_PS LE #WD'4i28' 
THEN 



At this point, the ECC position is within range (0. to 4128.). 
Next, find out if the ECC position counter (register) was used. 



If the ECC position register value equals an octal 4066, 
indicates the register was initialized but not used. 

SET VAR. ECCPS TO y.CND_$IF (REGISTER. RMECl.PS EQ #W0'4O66'. 
'Normal'. XCNV_$DECIMAL_P (REGISTER. RMECl.PS, 6)) ; 



it 
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ELSE 

SET VAR.ECCPS TO 'Outside of legal range' ; 
END.IF ; 

H the error was a non-correctable hard error or Error Correction 
was inhibited, then the ECC position and ECC pattern are irrelevant. 

IF (REGISTER. RMERl.ECH EQ TRUE) 
THEN 

BEGIN 

SET VAR.ECCPS TO 'Irrelevant (ECH set)' : 
SET VAR.ECCPAT TO "Irrelevant (ECH set)' ; 
END ; 

END.IF ; 

IF (REGISTER. RMQF [11] EQ TRUE) 
THEN 

BEGIN 

SET VAR.ECCPS TO 'Irrelevant (ECI set)* ; 
SET VAR.ECCPAT TO 'Irrelevant (ECI set)' ; 
END : 

ELSE 

SET VAR.ECCPAT TO XCNV_$OCTAL (REGISTER. RMEC2 [0:11], 4, '0') I ' (0) ' 

END.IF ; 



The following will use the register information to determine the 
value of the intermodule variables, which are needed by the 
dispatcher and stuff these accordingly. 

The variables are: 

INTERMOD_DEVERR . DRI VE.SN 
INTERMOD.DEVERR . DEV.FUNCTION 
INTERMOD.DEVERR . PHYS.UNIT 

INTERMOD.DEVERR . ERROR.CYLINDER 
INTERMOD_DEVERR . ERROR.SECTOR 
INTERMOD.DEVERR . ERROR.HEAD 

INTERMOD.DEVERR. ERROR.GROUP (not applicable to this device) 
INTERMOD.DEVERR . BLOCK.NUMBER 
INTERMOD.DEVERR . ERROR.TYPE 

Return the drive serial number. 
SET INTERMOD.DEVERR. DRIVE.SN TO 7,CNV.$BCD(REGISTER.RMSN, 12, ' ') ; 
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Look up the function code in the function table. 
FIND FUKCTION FUN_CODE = REGISTER. RMCSl.FN ; 

Check if a match is found between the register and the table, 

IF FUNCTION. CONTEXT 
THEN 

Yes, return the associated function text in the variable. 

SET INTERMOD_DEVERR.DEV_FUNCTION TO FUNCTION . FUN_TEXT ; 

ELSE 

Otherwise, return text indicating an invalid function. 

SET INTERMOD_DEVERR.DEV.FUNCTION TO 'Invalid function" ; 
END.IF ; 

Return the physical unit number. 
SET INTERMOD^DEVERR.PHYS.UNIT TO 7.CNV_$DECIMAL (REGISTER. RMCS2_UN, 1) ; 

DISK GEOMETRY INFORMATION. 

Calculate the intermodule variables for LBN. GROUP. CYLINDER, TRACK, 
and SECTOR address, initially assuming the error packet was NOT caused 
by a data error. 

Calculate LBN using the formula. . . 

LBN = ( CYLINDER_ADRS * number of SECTORS/CYL + 
HEAD.ADRS * number of SECTORS/TRACK + 
SECTOR_ADRS ) 

I 

SET INTERMOD_DEVERR.BL0CK_NUMBER TO 
y,CNV_$DECIMAL_P( 

(REGISTER. RMDC.DC * #LD'160' + 

REGISTER. RMDA.HD * #WD'32' + 

REGISTER. RMDA.SEC ), 

9) ; 
! 

! Initialize GROUP, (not applicable to this device) 
SET INTERMOD_DEVERR.ERR0R_GR0UP TO 'N/A' ; 

Initialize CYLINDER. 

SET INTERMOD_DEVERR.ERROR_CYLINDER TO 

y.CNV_$DECIMAL_P (REGISTER. RMDC.DC. 3) ; 
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Initialize TRACK (head) . 

SET ItITERMOD_DEVERR.ERROR_HEAD TO 

7.CNV_$DECIMAL_P (REGISTER . RMDA.HD . 



Initialize SECTOR. 



2) 



SET INTERMOD_DEVERR.ERRDR_SECTOR TO 

y.CNV_$DECIMAL_P (REGISTER. RMDA.SEC, 2) ; 

! 

! Correct the geometry information if necessary. 

Upon a data error, the hardware will update the GROUP, CYLINDER. TRACK and 
SECTOR to point to the sector following the sector in error. In order to 
make the intermodule variables for GROUP, CYLINDER, TRACK. SECTOR and LBN 
point to the media address causing a data error, they are corrected (backed 
off by 1) using the following algorithm. 



Was it a data error ? 
Yes, it was a data error. 
Decrement LBN. 

Was SECTOR = ? 

Yes, SECTOR = 0. 
SECTOR = SECTORMAX. 

Was TRACK = 0? 
Yes, TRACK = 0. 

TRACK = TRACKMAX. 

Decrement CYLINDER. 

! No, TRACK NOT = 0. 

! Decrement TRACK. 

No. SECTOR NOT = 0. 
Decrement SECTOR. 
No, it was not a data error. 



(check error bits) 

(correction (backoff) is needed) 
(recalculate pointing to previous BLK) 

(sector underflow boundary?) 
(underflow sector and borrow from TRK) 
(underflow the sector) 

(track underflow boundary?) 
(underflow TRK and borrow from CYL) 
(underflow the track) 
(borrow from CYL for TRK) 

(no underflow of TRK) 

(simply, with no borrow from CYL) 

(no underflow at all) 
(point to the previous block) 

(no correction (backoff) needed) 



Was it a data error? 

IF REGISTER. RMER1_DCK OR REGISTER. RMERl.ECH OR REGISTER . RMCS2_WC 
THEN 

! 

! Yes, it was a data error. (LBN and geometry information needs correction) 



BEGIN 
I 



! Correct the LBN by recalculating (backed off by one block) . 
! 

SET INTERMOD_DEVERR.BLOCK_NUNBER TO 
y,CNV_$DECIMAL_P( 
(REGISTER. RMDC_DC * #LD'160' + 
REGISTER. RMDA_HD * #WD'32' + 
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REGISTER. RMDA_SEC ) -1, 
9) ; 

Was the sector address zero? (sector underflow?) 

IF REGISTER. RMDA.SEC EQ #BD'00' 
THEN 

Tes, it was zero, (so underflow the sector and borrow from track) 

BEGIN 
Underflow the sector. 
SET INTERMOD_DEVERR.ERR0R_SECT0R TO '31.' ; 

Was track (head) address zero? (track underflow?) 

IF REGISTER. RMDA_HD EQ «BD'0O' 

THEN 

Yes, the track was 0, so underflow the track 
and borrow from the cylinder. 

BEGIN 
! 

! Underflow the track (head) . 
SET INTERMOD_DEVERR.ERR0R_HEAD TO '4.' ; 

Borrow from the cylinder. 

SET INTERMOD_DEVERR.ERROR_CYLINDER TO 

•/.CNV_$DECIMAL_P (REGISTER. RMDC_DC - i. 3) ; 
END : 

ELSE 

No, the track was not zero. Simply decrement it. (no track underflow) 

SET INTERMOD_DEVERR.ERROR_HEAD TO 

7.CNV_$DECIMAL_P (REGISTER. RMDA_HD - 1, 2) ; 
END_IF ; 
END ; 



ELSE 



No , the sector address was not zero . Simply decrement it . 
(no sector underflow) 



SET INTERM0D_DEVERR.ERROR_SECT0R TO 

XCNV_$DECIMAL_P (REGISTER. RMDA_SEC - 1, 2) ; 
END_IF ; 
END ; 
END.IF ; 
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Find the reason causing this error packet and set the variable 
accordingly . 

IF REGISTER. RMCS1_TRE 
THEN 

BEGIN 

IF NOT REGISTER. RMDS.ERR 
THEN 

DECODE 

INTERMOD_DEVERR.ERROR_TYPE = REGISTER ; 



RMCS2 [15] 

RMCS2 [14] 

RMCS2 [13] 

RMCS2 [12] 

RMCS2 [11] 

RMCS2 [10] 

RMCS2 [ 9] 

RMCS2 [ 8] 
END.DECODE ; 



Data Late 

Write Check Error 

U.B. Parity Error 

Nonexistent Drive 

Nonexistent Memory 

Program Error 

Missed Transfer 

MASSBUS Data Bus Parity Error 



ELSE 



DECODE 



INTERMOD_DEVERR.ERROR_TYPE = REGISTER ; 



RMER2 


:i5] 


! 


RMER2 


:i4] 




RMER2 


:i3] 




RMER2 


:i2] 




RMER2 


:ii] 




RMER2 


:io] 




RMER2 


: 7] 




RMER2 


: 3] 




RMERl 


: 6] 




RMERl 


15] 




RMERl 


14] 




RMERl 


13] 




RMERl 


12] 




RMERl 


11] 




RMERl 


10] 




RMERl 


9] 




RMERl 


8] 




RMERl 


7] 




RMERl 


5] 




RMERl i 


4] 




RMERl 1 


3] 




RMERl 1 


2] 




RMERl 1 


1] 




RMERl [ 


0] 





END.DECODE ; 
END.IF ; 



END 



ELSE 



DECODE 

INTERMQD.DEVERR . ERROR_TYPE 



Bad Sector Detected (Hdr bit) 

Seek Incomplete 

Operator Plug Error (removed) 

Invalid Command (W bit reset) 

Lost of System Clock 

Lost of Bit Clock 

Device Check 

Data Parity Error 

ECC Hard Error 

Data Check 

Drive Unsafe 

Operation Incomplete 

Drive Timing Error 

Write Lock Error 

Invalid Address Error 

Address Overflow Error 

Header CRC Error 

Header Compare Error 

Write Clock Fail 

Format Error 

Parity Error 

Register Modification Refused 

Illegal Register 

Illegal Function 



REGISTER ; 
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Medium not Online 

Drive not Present 
! Volume not Valid 

MASSBUS Control Bus Parity Error 

Drive not Available 
! Controller not Ready 



IF (INTEaiMOD_DEVERR.ERROR_TyPE EQ NULL) 
THEN 

SET INTERMOD_DEVERR.ERROR_TYPE TO 'No error bit found' 
END.IF ; 



NOT HMDS [12] 


! 


NOT RMDS [ 8] 


! 


NOT RMDS [ 6] 


! 


RMCSl [13] 


! 


NOT RMCSl [11] 


! 


NOT RMCSl [ 7] 


! 


END_DECODE ; 


END.IF ; 





All the intermodule variables have been stuffed, so return to the 
coroutine caller (calling dispatch module) . 

COROUTINE ; 

The dispatcher returns control to this module here, with the flag 
INTERMOD_DEVERR.PRINT_FLAG set to either TRUE or FALSE. If the 
flag is TRUE, a FULL or REGISTER report is in progress, the banner 
has been printed, and this module prints device registers (or data 
fields for paclset oriented devices). Otherwise, this module does 
not print anything, and simply exits back to the dispatcher. The 
width of the report (80/132) is controlled by dispatcher-defined 
format variables REPORT. Vlf_G_F_l and REPORT. W_G_F_2 based on the 
user- spec if led /WIDTH switch. 



IF INTERMOD_DEVERR.PRINT_FLAG 
THEN 

BEGIN 



Print the header for the Name, Value and Interpretation fields. 

WRITE 
FORMAT 
' ! SFCName ! 13FCValue ! 25FCInterpretation ! 2FL ' ; 

Print the registers according to the format variable (80/132) 
provided by the dispatcher. 



WRITE_6R0UP REGISTER 
FORMAT 



Print format for the register name 
and its associated value. 

REPORT. W_G_F_1, 
! 

! Print format for the exploded bits and fields. 
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REPORT. W_G_F_2 ; 

If there are any NOTES to be printed, this is where the 
PUT of note indices is done on the note file. When the 
return from this module is done, the dispatching module 
examines the note file to determine if the note module 
NRM23 should be called to print the notes specified by 
index number. 



! If the unused bits 5 to 7 are set in the RMQA register. 



IF (REGISTER. Rlffi)A [5:3] NE #BB'0') 
THEN 



Print the note saying that it may cause an invalid 
sector address to be recognized resulting in a 
possible invalid address error. 



PUT NOTE.NUMBERS INDEX = 1 
END.IF ; 



END ; 
END.IF ; 
END ; 



END.MODULE 



<D 



4.6.2 The DSP2P1 Dispatcher Module 

The following example is an annotated listing of the DSP2P1 dispatcher module: 
MODULE DSP2P1 'POl.OO' ; 



ERROR LOG CONTROL FILE MODULE: DSP2P1 

COPYRIGHT (c) 1981 BY 
DIGITAL EQUIPMENT CORPORATION, MAYNARD 
MASSACHUSETTS. ALL RIGHTS RESERVED. 

! THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED 
! AND COPIED ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE 
! AND WITH THE INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS 
! SOFTWARE, OR ANY OTHER COPIES THEREOF, MAY NOT BE PROVIDED OR 
! OTHERWISE MADE AVAILABLE TO ANY OTHER PERSON. NO TITLE TO AND 
! OWNERSHIP OF THE SOFTWARE IS HEREBY TRANSFERRED. 

! THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT 
! NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL 
! EQUIPMENT CORPORATION. 

DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF 
ITS SOFTWARE ON EQUIPMENT THAT IS NOT SUPPLIED BY DIGITAL. 

VERSION 01.00 
! C. PUTNAM 22-SEP-80 
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This module is called to process Device Error packets. 
Module Name: DSP 2 P 1 

Module Prefix: ! 

Error Code: 

Operating System: 

Packet Format: 

The following Error Subcodes are defined: 

Subcode Mnemonic Meaning 









1 

2 
3 

4 


E_$SDVH 
E_$SDVS 
E_$STMO 
E_$SUNS 


Device Hard Error 
Device Soft Error 
Device Interrupt Timeout 
Unsolicited Interrupt 



Define any literals used in this module . 

LITERAL DSP2_SUB_ANY.F0RMAT_1 = 

'I/O Operation Information :! IFL ' I 
I J2FLI I 

'!5FCDevice Function !38FCType of Error !2FL' I 
' ! 5FC ! 30DP ! 38FC ! 30DP ! 3FL " ; 

LITERAL DSP2_SUB_ANY.F0RMAT_2 = 

•Device Error Position Information: ! IFL' I 

' !2FL' I 

' ! SFCCylinder ! 15FCGrou> ! 22FCHead ! 28FCSector ! 36FCBlock I 2FL ' | 
• ! 5FC ! 8DP ! 15FC ! 5DP ! 22FC ! 4DP ! 28FC ! 6DP ! 36FC ! lODP ! 2FL ' ; 

PROCEDURE START_MOD 
BEGIN 

Create the Subcode Conversion table. 

TABLE SUBCODE ; 

NUMBER :WORD ; 

TEXT : ASCII [18] ; 

BEGIN.TABLE 

1, 'Device Hard Error' ; 

2, 'Device Soft Error' ; 

3, 'Device Timeout' ; 

4, 'Spurious Interrupt' ; 
END_TABLE ; 

o 

! Create a flag that indicates whether the device is a magtape or not. 

DECLARE INDICATE ; 

TAPE.FLAG : LOGICAL ; 
END.DECLARE ; 
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! First check to see if PERIPHERAL errors are selected. If they are not, 
! simplj return. Also determine the packet subtype. If it is a known 
! subtype code, then proceed. Otherwise it is an error. 

IF NOT REPORT. PERIPHERAL 

THEN 
I 

! This type of packet has not been selected for printing. 
! 

RETURN : 
END^IF ; 

FIND SUBCODE NUMBER = HEADER . CODE.SUBTYPE ; 
IF NOT SUBCODE. CONTEXT 
THEN 

BEGIN 

SIGNAL 'ILLPACSBC PARAMETERS 

REPORT . PACKET.IDENT . 

7.CNV_$DECIMAL (HEADER . CODE_TYPE . 3) . 

XCNV^IDECIMAL (HEADER. CODE_SUBTYPE, 3) ; 

RETURN : 
END ; 

END_IF ; 



Now find the device name by calling the DEVICE_NAME procedure. 
CALL MODULE 'DEVSMl' PROCEDURE • DEVICE.NAME ' ; 

e 

Prepare the NOTE.NUMBERS file for any notes that may be requested. 
POINTER NQTE.NUMBERS CLEAR ; 

o 

Now set up the procedure DEVICE_ERROR and the appropriate device-level 
nodule as a coroutine pair. 

CALL MODULE INTERMOD_DEVERR.DISP_NAME PROCEDURE ' DEVICE_ENTRY ' 

COROUTINE 'DEVICE.ERROR' ; 
END ; 

PROCEDURE DEVICE.ERROR 
BEGIN 

The following is used to format the output for the 

'Device Hard Error', 'Device Soft Error', 'Device Interrupt Timeout' 

and 'Spurious Interrupt' Device Error packets. 

The DEVICE_ID subpacket contains information about the 
device on which the error occurred. 

The IO_ACTIVITY subpacket contains information about all 
other concurrent I/O in the system. 
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! The DEVICE.OP subpacket contains Information about the I/O 
! Operation in progress on the device at the time of the error. 
I 



! Obtain information from the coroutine partner. 
I 



COROUTINE 



Assume the serial number test will succeed or be irrelevant. 

SET INTEIIM0D_DEVERR.REJECT_FLA6 TO FALSE ; 

! Now test to see if this device passes the drive serial number test. 

T 

IF REPORT. DRIVE_SN_ VALID AND 

(INTERMOD_DEVERR.DRIVE_SN NE XCNV.SBCD (REPORT . DRIVE.SN . 12)) 

THEN 

Indicate that the test failed. 

SET INTERMOD_DEVERR.REJECT,FLAG TO TRUE : 
END.IF : 

Determine the type of report and format the output 
accordingly. 

CASE REPORT. MODE OF 

['BRIEF']: 
I 



! The BRIEF report is one line long. 

! 

BEGIN 

! 

! Now output the information based on the result of the test. 

o 

IF NOT INTERMOD_DEVERR.REJECT_FLAG 

THEN 
! 

! Now output the brief report. 

BEGIN 
WRITE 

I^ORT . PACKET.IDENT . 

XCNV_$RSX_TIME (HEADER . TIME.STAMP , 0) , 

SUBCODE. TEXT, 

DISP.DEVICE.STRING, 

INTERMOD_DEVERR . ERROR.TYPE , 

•Function = ' I INTERMOD_DEVERR.DEV_FUNCTION 
FORMAT 

REPORT. BRIEF_FORMAT ; 
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! Now increment the printed packet count. 
! 

INCREMENT REPORT. PRINT.COUNT ; 
END : 

END.IF ; 

Now go back to the partner. It will simply return 
without printing. 

SET INTERMOD_DEVERR.PRINT_FLAG TO FALSE ; 
END : 

['FULL'. 'REGISTERS']: 

The FULL report contains detailed information 
about the error. 



BEGIN 
! 

! Now output the information based on the result of the test. 

® 

! 

IF NOT INTERMOD_DEVERR.REJECT_FLAG 

THEN 
! 

! Output the first page if the report type is 'FULL' . 

BEGIN 

IF REPORT. MODE EQ 'FULL' 

THEN 

How output the information for the standard subpackets. 

BEGIN 

CALL MODULE REPORT . FULL.MOD PROCEDURE ' OUTPUT.PACKETS ' ; 

r 

! Now output the Data subpacket information. 

VllRITE 

INTERMOD_DEVERR . DEV.FUNCTION , 
INTERMOD.DEVERR . ERROR.TYPE 
FORMAT 

DSP2_SUB_ ANY. FORMAT. 1 ; 

Now output the Device Error Position information 
if it is applicable. 

IF INTERMOD.DEVERR. ERROR.CYLINDER NE '???' 
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THEN 

WRITE 

INTERMOD_DEVERR . ERROR.CYLINDER . 
INTERMOD.DEVERR . ERROR.GROUP . 
INTERMOD_DEVERR . ERROR.HEAD . 
INTERMOD_DEVERR . ERROR.SECTOR , 
INTERMOD_DEVERR . BLOCK.NUMBER 
FORMAT 

DSP2_SUB_ANY.F0RMAT_2 : 

END_IF ; 
! 

! A full report i& wanted, so print the record I.D. 
! and header. 

WRITE 

REPORT . PACKET.IDENT 
FORMAT 

■ ! IFP ! BFCEntry ! DP ! 22FC(continued) ! 3FL ' I 
'Device Supplied Information: !FL' I 
1 I2FL' ; 

END ; 



ELSE 



Only a register dump is requested, therefore print 
the banner from the full report. 

WRITE 

REPORT . PACKET. IDENT , 
%CNV_$DECIMAL_P (HEADER . ERROR.SEQ . 8) , 
DISP.DEVICE.STRING, 
SUBCODE. TEXT. 

XCND_$IF((INTERMOD_DEVERR.ERROR_TYPE NE NULL). 
'CI INTERMOD.DEVERR.ERROR.TYPE I ')'. 
NULL). 
y.CNV_$RSX_TIME (HEADER . TIME_STAMP . 0) 
FORMAT 

! Select the format statement 
! based on the desired width. 

XCND_$IF (REPORT . WIDE , 
! 

! WIDE is selected. 

'!lFP!5FCEntry ! 7DP ! 20FCSequence !9DP' I 
' ! 40FC ! 6DP ! 48FC ! 18DP ! DP ! 2FS ! 20DP ! 3FL ' I 
'Device Supplied Information : !FL' I 
' — !2FL', 

! NARROW is selected. 
! 

' ! IFP ! SFCEntry ! 7DP ! 20FCSequence ! 9DP I 40FC ! 6DP ! FL ' 
' ! 5FC ! iSDP ! DP ! 2FS ! 20DP ! 3FL ' I 
'Device Supplied Information: !FL' I 
I !2FL') ; 



END_IF 
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! Now increment the printed packet count and tell the device 

! module we wemt it to print. 

! 

INCREMENT REPORT . PRINT.COUNT ; 

SET INTERMOD_DEVERR.PRINT_FLAG TO TRUE ; 

END ; 

ELSE 

We don't want to print because the packet was rejected. 

SET INTERMOD_DEVERR.PRINT_FLAG TO FALSE ; 

END_IF ; 

! Now go back to the partner. It will output the device registers 

! if the print flag is true. 

! 

END : 

© 

[•NQKE'3: 

If the report type is NONE, output nothing. 

SET INTERMOD_DEVERR.PRINT_FLAG TO FALSE ; 
END_CASE : 

Now COROUTINE back to the partner. It will print if instructed to do so. 
COROUTINE ; 

! Test to see if the packet was accepted. If it was, update the files. 

! 

IF NOT INTERMOD_DEVERR.REJECT_FLAG THEN 

! 

! Update the files. 

! 

CALL PROCEDURE 'UPDATE_RECORD' ; 

END_IF ; 

! Now see if any notes were requested euid print them if there were. 

! 

IF NOTE_NUMBERS. CONTEXT THEN 

BEGIN 

SET INTERM0D_DEVERR.DISP_NAME to 'N' I 

%STR_$REMAINING(INTERMOD_DEVERR.DISP_NAME. 2) ; 

IF y.PKT_$MODULE (INTERMOD.DEVERR . DISP.NAME) 

THEN 

CALL MODULE INTERMOD.DEVERR . DISP.NAME PROCEDURE 'NOTES' ; 



4-56 Error Log Control File Architecture 



ELSE 

SIGNAL 'NONOTES' PARAMETERS INTERMOD_DEVERR.DRIVE.TYPE ; 

END.IF ; 
END ; 

END.IF ; 
END ; 

PROCEDURE UPDATE_RECORD 

BEGIN 

This procedure is used to update an error type record if a record for the 
type of error exists. If it does not exist, a record is created. 

First see if a record exists in the ERROR_INFQ_E file that matches 
on the following keys: 

Device name 
Device type 
Pack SN 
Drive SN 
Volume label 
Error type 



IF REPORT. ERROR 
THEN 

This type of summary is desired. 

BEGIN 

POINTER ERROR_INFO_E FIRST ; 

Now try to find a record that matches on all of the keys. 

FIND ERROR_INFO_E 

NAME = DISP.DEVICE_STRING. 

DEVICE.TYPE = XCND_$IF(INTERMOD_DEVERR.MISMATCH_FLAG. '*', NULL) 

INTERMOD_DEVERR . DRIVE.TYPE , 
PACK.SN = DEVICE_ID.PACK_SN. 
DRIVE.SN = INTERMOD.DEVERR.DRIVE.SN. 
VOLUME_LABEL = DEVICE_ID.VOLUME_LABEL, 
ERROR_TYPE = INTERMOD.DEVERR . ERROR.TYPE ; 

! See if there was a match. 

! 

IF ERROR_INFO_E. CONTEXT 

THEN 



There was a match. Update the record to 
show that this error occurred. 

BEGIN 

INCREMENT ERROR_INFO_E . ERROR.COUNT ; 

IF DISP.PACKET.DATE LT ERROR_INF0_E . FIRST.DATE 

THEN 
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BEGIN 

SET ERROR_INFO_E.FIRST_DATE TO DISP . PACKET.DATE ; 

SET ERROR_INFO_E.FIRST_PACKET TO REPORT. PACKET. IDENT 
END : 

END_IF ; 

IF DISP. PACKET.DATE GT ERROR_INFO_E . LAST.DATE 

THEN 

BEGIN 

SET ERROR_INFO_E.LAST_DATE TO DISP. PACKET.DATE ; 

SET ERROR_INFO_E.LAST_PACKET TO REPORT. PACKET. IDENT ; 
END ; 

END.IF ; 
END : 



ELSE 



! This is the first error of this kind. Create a record in the 
! ERROR.INFO.E file that describes this error. 

PUT ERROR.INFG.E 

NAME = DISP.DEVICE.STRING, 

DEVICE_TYPE = %CND.$IF(INTERMOD.DEVERR.MISMATCH.FLAG. '*', NULL) I 

INTERMOD.DEVERR . DRIVE.TYPE , 
PACK.SN = DEVICE.ID.PACK_SN, 
DRIVE.SN = INTERMOD.DEVERR. DRIVE.SN. 
VOLUME.LABEL = DEVICE.ID . VOLUME.LABEL . 
ERROR.TYPE = INTERMOD.DEVERR . ERROR.TYPE , 
ERROR.COUNT = 1, 
FIRST.DATE = DISP. PACKET.DATE, 
LAST.DATE = DISP. PACKET.DATE, 
FIRST_PACKET = REPORT . PACKET. IDENT , 
LAST.PACKET = REPORT . PACKET.IDENT ; 



END.IF ; 
END : 

END.IF ; 

First see if a record exists in the ERROR.INFO.G file that matches 
on the following keys: 

Device name 
Device type 
Pack SN 
Drive SN 
Volume label 
Block number 

<D 

IF REPORT. GEOMETRY AND NOT INDICATE . TAPE.FLAG 

THEN 
! 

! This type of summary is desired. 

BEGIN 

POINTER ERROR_INFO.G FIRST ; 
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! Now try to find a record that matches on all of the keys . 

! 

FIND ERROR_INFO_G 

NAME = DISP.DEVICE.STRING. 

DEVICE_TYPE = XCND_$IF(INTERMOD_DEVERR.MISMATCH_FLAG, ■*'.NULL) I 
INTERMOD_DEVERR . DRIVE.TYPE , 
PACK_SN = DEVICE. ID. PACK_SN. 
DRIVE.SN = INTERMOD_DEVERR.DRIVE_SN. 
VOLUME_LABEL = DEVICE. ID. VOLUME.LABEL, 
BLOCK.NUMBER = INTERMOD.DEVERR . BLOCK.NUMBER ; 

! See if there was a match. 
IF ERROR_INF0_G. CONTEXT 

THEN 

There was a match. Update the record to 
show that this error occurred. 

INCREMENT ERROR_INFO_G.ERRDR_CDUNT ; 
ELSE 

This is the first error of this kind. Create a record in the 
ERROR_INFO_G file that describes this error. 

PUT ERROR.INFO.G 

NAME = DISP.DEVICE_STRING, 

DEVICE_TYPE = %CND_$IF(INTERMOD_DEVERR.MISMATCH_FLAG, '*' . NULL) 

INTERMOD.DEVERR . DRIVE.TYPE . 
PACK.SN = DEVICE_ID.PACK.SN. 
DRIVE_SN = INTERMOD_DEVERR.DRIVE_SN, 
VOLUME.LABEL = DEVICE.ID . VOLUME.LABEL . 
ERROR.HEAD = INTERMOD.DEVERR . ERROR.HEAD , 
ERROR.GROUP = INTERMOD.DEVERR.ERROR.GROUP. 
ERROR.CYLINDER = INTERMOD_DEVERR.ERROR_CYLINDER. 
ERROR.SECTOR = INTERMOD.DEVERR. ERROR.SECTOR. 
BLOCK_NUMBER = INTERMOD.DEVERR. BLOCK.NUMBER. 
ERROR.COUNT = 1 ; 



END.IF ; 
END : 

END.IF ; 
END ; 

END_MODULE ; ! DSP2P1.CNF 
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4.6.3 The RM02/03 Notes Module NRM23 

The following example is an annotated listing of the notes module for the RM02 and RM03 
disk drives: 



MODULE NRM23 'MO 1.00' ; 

ERROR LOG CONTROL FILE MODULE: RM02. RM03 Notes 

COPYRIGHT (c) 1981 BY 
DIGITAL EQUIPMENT CORPORATION. MAYNARD 
MASSACHUSETTS. ALL RIGHTS RESERVED. 
! 

! THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED 
! AND COPIED ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE 
! AND WITH THE INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS 
I SOFTWARE. OR ANY OTHER COPIES THEREOF, MAY NOT BE PROVIDED OR 
! OTHERWISE MADE AVAILABLE TO ANY OTHER PERSON. NO TITLE TO AND 
! OWNERSHIP OF THE SOFTWARE IS HEREBY TRANSFERRED. 

! TjHE INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT 
! NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL 
! EQUIPMENT CORPORATION. 

! DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF 
! ITS SOFTWARE ON EQUIPMENT THAT IS NOT SUPPLIED BY DIGITAL. 

! VERSION 01.00 
! 

! R. Ryan 30-Jun-81 

! This is one of the many device modules, which is called by the device 
! error dispatcher (DSP2P1) or device information dispatcher (DSP3P1) 
! to process notes for all the device-dependent information. 



PROCEDURE NOTES 

This procedure, which is called from the DSP2P1 module, processes any 
requests for notes. 

BEGIN 
! 

! Print the NOTE header and define the format for the NOTE section. 

e 

WRITE FORMAT 

'!3FLNotes on RM02, RM03 errors: !2FL' ; 

POINTER NOTE_NUMBERS FIRST ; 

WHILE NOTE.NUMBERS. CONTEXT DO 



o 



BEGIN 

SELECT NOTE.NUMBERS. .INDEX OF 
! 

! Note number 1. 
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BEGIN 

VmiTE FORMAT 

'* RMDA bits 5.6.7 are unused, however if they are' 
WRITE FORMAT 

■ set, they will be interpreted as the high order' 
WRITE FORMAT 

' bits of the sector address. This may result in' 
WRITE FORMAT 

' an Invalid Address Error. !3FL' ; 
END : 



ELSE 



I This is an unknown note number. 

! 

SIGNAL 'UNKNWNNOT' PARAMETERS 

XCNV_$DECIMAL_P (NOTE_NUMBERS . INDEX . 3) . 

INTERMOD_DEVERR.DRIVE_TYPE ; 

END_SELECT ; 



POINTER NOTE.NUMBERS NEXT 
END ; 



END 



END.MODULE 



! NRM23.CNF 



4.6.4 Subpacket Definitions 

This section lists the DIGITAL-standard subpackets. These subpackets are declared by the 
following modules: 

• The HEADER subpacket contains information largely from SYSCM. It describes the 
characteristics of the system and packet. This subpacket is always required. 



SUBPACKET HEADER = DISP . NEXT.PACKET ; 


SUBPKT_FLAGS 


WORD : 


! E$HSBF 


SFLG_HDR 


BIT [0] 


* HEADER Subpacket 


SFLG.TSK 


BIT [1] 


! TASK Subpacket 


SFLG_DID 


BIT [2] 


! DEVICE.ID Subpacket 


SFLG_DOP 


BIT [3] 


! DEVICE.OP Subpacket 


SFLG_DAC 


BIT [4] 


! DEVICE.AC Subpacket 


SFLG.DAT 


BIT [5] 


! DATA Subpacket 


SFLG_MBC 


BIT [13] 


; ! 22-bit MASSBUS Controller 


SFLG_CMD 


BIT [14] 


; ! Command Subpacket 


SFLG.ZER 


BIT [15] 


; ! I/O counts zeroed 


OP.SYS 


BYTE ; 


! E$HSYS 


FORMAT.ID 


BYTE ; 


! E$HIDN 


OP_SYS_ID 


ASCII [4; 


; ! E$HSID 
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E$HCTX 

Normal Entry 

Start Entry 

CDA Entry 

E$HFLG 

Addressing mode 

Error Counts supplied 

Q-6US system 

E$HENS 

E$HERS 

ESHTYC 

E$HTYS 

E$HTIM 

E$HPTY 

Reserved byte 

E$HURM 

Processor Identifier 



The TASK subpacket contains information about either the task that logged the packet or 
the task that caused the packet to be logged. 

SUBPACKET TASK = DISP . NEXT_PACKET ; 

E$TTSK 

ESTUIC 

Member number in UIC 

Group number in UIC 

E$TTID 

ESTTIU 

E$TFLG 

Privileged Task 

Privileged Terminal 

The DEVICE _JD subpacket contains information about the device on which the error 
occurred. 



CONTEXT.CODE 


BYTE 




CC.NOR 


BIT [0] ; 


CC.STA 


BIT [1] ; 


CC.CDA 


BIT [2] ; 


FLAGS 


BYTE : 


FLG_ADR 


FIF.r.I) [0:2] 


FLG.COU 


BIT [2] ; 


FLG_QBS 


BIT [3] ; 


EKTRY.SEQ 


WORD 




ERROR.SEQ 


WORD 




CODE_TYPE 


BYTE 




CODE_SUBTyPE 


BYTE 




TIME_STAMP 


RSX.TIME ; 


PROC.TYPE 


BYTE 




RESERVED 


BYTE 




PROC_ID 


WORD 




URM_CPU 


FIELD [0:4] 


END.PACKET ; 







TASK.NAME 


LONGWORD ; 


UIC 


WORD ; 


UICMEMBER 


FIELD [0:8] 


UIC.GROUP 


FIELD [8:8] 


TI.DEV 


ASCII [2] ; 


TI.UNIT 


BYTE ; 


FLAGS 


BYTE ; 


FLG_PRV 


BIT [0] ; 


FLG.PRI 


BIT [1] ; 



SUBPACKET DEVICE_ID = DISP . NEXT_PACKET 



MNEMONIC 


ASCII 


[2] 


LOGICAL.UNIT 


BYTE 




CONTROLLER.NUM 


BYTE 




PHYS.UNIT 


BYTE 




PHYS_SUB_UNIT 


BYTE 




$IF SUPPORT. RSX_ 11 


LM.PLUS 


$THEN 




IF OP.SYS.SUFI 


'IX EQ 'P' 


THEN 




BEGIN 




PHYS_DEV_MNEMON 


: ASCII [2] 


END : 




END.IF ; 




$END_IF 




DEV.FLAGS 


:BYTE : 


DFLG.SUB 


:BIT 


[0] ; 



! E$ILDV 
! E$ILUN 
! E$IPCO 
! E$IPUN 
! E$IPSU 



E$IPDV 



! E$IFLG 

! Subcontroller device 
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$IF SUPPORT. RSX_11M_PLUS 



$THEN 




DFLG.NUX 


BIT [1] ; 


$END_IF 




RESERVED 


BYTE ; 


VOLUME.LABEL 


ASCII [12] 


PACK_SN 


LONGWORD ; 


DEV_TYPE_CLASS 


WORD : 


DEV.TYPE 


LONGWORD ; 


lO.COUNT 


LONGWORD ; 


SOFT.ERCNT 


BYTE ; 


HARD.ERCNT 


BYTE ; 


$IF SUPPORT. RSX_11I 


<_PLUS 


$THEN 




IF OP.SYS.SUFF 


EX EQ 'P' 


THEN 




BEGIN 




WRD_XFR_COUNT 


: LONGWORD : 


CYL_CRS_COUNT 


: LONGWORD : 


END ; 




END_IF ; 




$END_IF 





! No UCB extension 



Reserved byte 

E$IVOL 

E$IPAK 

E$IDCL 

E$IDTY 

E$IOPR 

E$IERS 

E$IERH 



! E$IBLK 
! E$ICYL 



END.PACKET ; 

The DEVICE_OP subpacket contains information about the requested I/O operation. 



SUBPACKET DEVICE_OP = DISP . NEXT.PACKET ; 




TASK.NAME 


LONGWORD : ' 


E$OTSK 


UIC 


WORD ; 


E$OUIC 


UIC.MEMBER 


FIELD [0:8] ; 


Member number in UIC 


UIC.GROUP 


FIELD [8:8] ; 


Group number in UIC 


TI.DEV 


ASCII [2] ; 


E$OTID 


TI.UNIT 


BYTE : 


ElOTIU 


RESERVED 


BYTE : 


Reserved Byte 


lO.FUNCTION 


WORD ; 


E$OFNC 


SF.IQX 


BIT [0] ; 


iq.X aubfunction bit 


SF.IQQ 


BIT [1] : 


IQ.q subf unction bit 


SF.iqUMD 


BIT [2] ; 


IQ.UMD subf unction bit 


FLAGS 


BYTE ; 


E$OFLG 


FLG_TRA 


BIT [0] ; 


Transfer operation 


FLG.DMA 


BIT [1] ; 


DMA device 


FLG_BAE 


BIT [2] ; 


22-bit addressing device 


RESERVED 


BYTE ; 


Reserved Byte 


XFER_ADDRF-SS_1 


WORD : 


E$OADD + 


XFER1_HIGH_2 


FIELD [4:2] ; 


High Order 2 bits of address 


XFER1_HIGH_6 


FIELD [0:6] : 


High Order 6 bits of address 


XFER_ADDRESS_2 


WORD ; 


E$0AOD * 2 


XFER2_TAUB 


: FIELD [0:13] ; 


T. A. in units of bytes 


XFER_BYTE_COUNT 


:WORD ; 


E$OSIZ 


RETRIES_LEFT 


:BYTE ; 


E$GRTY 


MAX_RETRIES 


:BYTE ; 


! E$0RTY+1 


END_PACaCET ; 
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• The IO_ACTIVITY subpacket contains information about other I/O occurring in the system 
at the time the error was detected. 

SUBPACKET IO_ACTIVITY = DISP . NEXT.PACKET REPEATED ; 



MNEMONIC 


ASCII 


[2] ; 


! ESALDV 


LOGICAL.UNIT 


BYTE 




! E$ALUN 


CONTROLLER_NU 


BYTE 




! E$APCQ 


PHYS.UNIT 


BYTE 




! E$APUN 


PHYS_SUB_UNIT 


BYTE 




! E$APSU 



$IF SUPPORT. RSX_11M_PLUS 
$THEN 

IF OP_SYS. SUFFIX EQ 'P' 

THEN 



: ASCII [2] 



BEGIN 

PHYS_DEV_MNEMON 
END ; 

END_IF ; 

$END_IF 

DEV.FLAGS :BYTE ; 
DFLG.SUB :BIT [0] 
$IF SUPPORT. RSX_11M_PLUS 

$THEN 



! ESIPDV 



! E$IFLG 

I Subcontroller device 



DFLG_NUX 


:BIT [1] ; 


! No UCB extension 


$END_IF 






TI.UNIT 


:BYTE ; 


! EIATIU 


TASK.NAME 


LONGWORD : 


! EIATSK 


UIC 


WORD : 


< E$AUIC 


UICMEMBER 


FIELD [0:8] ; 


Member number in UIC 


UIC.GROUP 


FIELD [8:8] ; 


Group number in UIC 


TI.DEV 


ASCII [2] ; 


E$ATID 


lO.FUNCTIQN 


WORD : 


E$AFNC 


SF_IQX 


BIT [0] ; 


IQ.X subf unction bit 


SF.IQQ 


BIT [1] ; 


IQ.Q subf unction bit 


SF.IQUMD 


BIT [2] ; 


iq.UMD subf unction bit 


FLAGS 


BYTE ; 


E$AFLG 


FLG.TRA 


BIT [0] ; 


Transfer operation 


FLG_DMA 


BIT [1] ; 


DMA device 


FLG_BAE 


BIT [2] ; 


22-bit addressing device 


RESERVED 


BYTE ; 


Reserved Byte 


XFER_ADDRESS_1 


WORD ; 


E$AADD * 


XFJiHl_HIGH_2 


FIELD [4:2] ; 


High Order 2 bits of address 


XFERi_HIGH.6 


FIKT.D [0:6] ; 


High Order 6 bits of address 


XFER_ADDRESS_2 


WORD ; 


E$AADD + 2 


XFER2_TAUB 


FIELD [0:13] ; 


T. A. in units of bytes 


XFER_BYTE_COUHT 


WORD : ! 


E$ASIZ 


END_PACKET ; 







4-64 Error Log Control File Architecture 



4.6.4.1 Subpackels Declared by DSP 1 PI 

This section describes the DATA subpackets declared by DSPIPI. 

• The following DATA subpacket (Code = 1, Subcode = 1) contains information about a 
status-change operation: 

SUBPACKET DATA = DISP . NEXT.PACKET ; 



LIMIT.CODE 


BYTE ; 


LOG.CODE 


BYTE : 


FLAGS 


BYTE ; 


FLG_CRE 


BIT [0] ; 


FILE_SPEC_LEN 


BYTE ; 


FTI.E.SPEC 


ASCII [80] 


EKD.PACKET ; 





The following DATA subpacket (Code = 1, Subcode = 2) contains information about a 
switch-logging-files operation: 



SUBPACKET DATA = DISP . NEXT.PACKET 



RESERVED 


WORD : 


FLAGS 


BYTE ; 


FLG_CRE 


BIT [0] ; 


FLG.DEL 


BIT [1] : 


FILE_SPEC_LE 


BYTE ; 


FILE,SPEC 


ASCII [80] 


END_PACKET ; 





The following DATA subpacket (Code = 1, Subcode 
append-to-file operation: 

SUBPACKET DATA = DISP . NEXT.PACKET ; 



3) contains information about an 



RESERVED 


WORD ; 


FLAGS 


BYTE ; 


FLG.CRE 


BIT [0] ; 


FLG.DEL 


BIT [1] : 


FILE_SPEC_LEN 


BYTE : 


FILE_SPEC 


ASCII [80] 


END_PACKET ; 





The following DATA subpacket (Code = 1, Subcode = 4) contains information about a 
set-backup-file operation: 



SUBPACKET DATA = DISP . NEXT.PACKET 


RESERVED 


WORD : 


FLAGS 


BYTE ; 


FILE_SPEC_LEN 


BYTE ; 


FILE_SPEC 


ASCII [80] 


END.PACKET ; 
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The following DATA subpacket (Code = 1, Subcode 
change-limits operation: 



6) contains information about a 



SUBPACKET DATA = DISP . NEXT.PACKET 


HARD_LIM_FLAG 


BYTE ; 


NEW_LIMH 


BIT [0] ; 


HARD.LIMIT 


BYTE ; 


SOFT_LIM_FLAG 


BYTE ; 


NEW_LIMS 


BIT [0] ; 


SDFT.LIMIT 


BYTE ; 


MNEMONIC 


ASCII [2] 


LOGICAL.UNIT 


BYTE ; 


RESERVED 


BYTE ; 


END.PACKET ; 





4.6.4.2 Subpackets Declared by DSP2P1 

The DATA subpackets for device errors (Code = 2, Subcodes = 1, 2, 3) contain information that 
is specific to each device. See the appropriate device-level module for the format of the DATA 
subpacket. 

4.6.4.3 Subpackets Declared by DSP3P1 

The DATA subpackets for device information messages (Code = 3, Subcode = 1) contain 
information that is specific to each device. See the appropriate device-level module for the 
format of the DATA subpacket. 

4.6.4.4 Subpackets Declared by DSP4P1 

There is no DATA subpacket for mount, dismount, and device-information reset events (Code 
= 4, Subcodes = 1, 2, 3). 

The following DATA subpacket (Code = 4, Subcode = 4) contains information about a block- 
replacement operation: 



SUBPACKET DATA = 


= DISP 


NEXT.PACKET 


FLAGS 






WORD ; 


PRIMARY. 


RBN 




BIT [0] ; 


SUCCESS 






BIT [1] ; 


LBN 






LONGWORD 


NEW.RBN 






LONGWORD 


OLD_RBN 






LONGWORD 


END.PACKET ; 









4.6.4.5 Subpackets Declared by DSP5P1 

The following DATA subpacket (Code = 5, Subcode = 1) contains information about a memory 
parity error event: 



SUBPACKET REGISTER = DISP.NEXT.PACKET NAMED 



RESERVED 


WORD 


RESERVED 


WORD 


P.CSROO 


WORD 


P.CSROl 


WORD 


P_USH02 


WORD 



Mask for Cache Registers 
Mask for Parity CSRs 
Memory Parity CSR 00 
Memory Parity CSR 01 
Memory Parity CSR 02 
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Memory Parity CSR 03 
Memory Parity CSR 04 
Memory Parity CSR 05 
Memory Parity CSR 06 
Memory Parity CSR 07 
Memory Parity CSR 08 
Memory Parity CSR 09 
Memory Parity CSR 10 
Memory Parity CSR 11 
Memory Parity CSR 12 
Memory Parity CSR 13 
Memory Parity CSR 14 
Memory Parity CSR 15 
Lovf Error Address Register 
High Error Address Register 
Cache Error Register 
Cache Control Register 
Cache Maintenance Register 
Cache Hit/Miss Register 



= 5, Subcode = 2) contains information about an unknown 



P_CSR03 :WORD 

pZcSR04 :W0RD 

P_CSR05 :WORD 

P_CSR06 :WORD 

P_CSR07 :WORD 

P_CSR08 :WORD 

P_CSR09 :WORD 

pIcSRIO :W0RD 

P_CSR11 :WORD 

P_CSR12 :WORD 

P_CSR13 :WORD 

P_CSR14 :W0RD 

P_CSR15 :WORD 

LaW_ERR :WORD 

HIGHERR :WORD 

CACHERR :WORD 

CSHCTRL :WORD 

CSHMAIN :WORD 

CACHET :WORD 
END.PACKET ; 

The following DATA subpacket (Code 
interrupt event: 

SUBPACKET DATA = DISP . NEXT.PACKET ; 

VECTOR_DVER_FOim :BYTE ; 

LOST.INT :BYTE ; 

END.PACKET ; 

4.6.4.6 Subpackets Declared by DSP6P1 

The power recovery event (Code = 6, Subcode = 1) has no DATA subpacket. 

4.6.4.7 Subpackets Declared by DSP7P1 

The following DATA subpacket (Code = 7, Subcode = 1) contains information about a time- 
change event: 



DISP.NEXT_PACKET 
:RSX_TIME ; 



SUBPACKET DATA 

NEW.TIME 
END_PACKET ; 

The following DATA subpacket (Code = 7, Subcode = 2) contains information about a system- 
crash event: 



SUBPACKET DATA = 
CRASH_TIME 
OP_SYS 
FORMAT.ID 
OP_SYS_ID 
TASK.NAME 
TI_DEV 
TI_UNIT 
FLAGS 

KERNEL_APR5 
URM 

URM.CPU 

END.PACKET ; 



DISP.NEXT.PACKET ; 
:RSX.TIME ; 
:BYTE ; 
:BYTE ; 
: ASCII [4] ; 
:L0NGWORD ; 
: ASCII [2] ; 
-.BYTE ; 
:BYTE ; 
:LONGWORD ; 
:W0RD : 
: FIELD [0:4] 
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The following DATA subpacket (Code = 7, Subcodes = 3, 4) contains information about a 
driver-load or driver-unload event: 

SUBPACKET DATA = DISP . NEXT_PACKET ; 
DRIVER_NAME : ASCII [2] ; 

END_PACKET ; 

The following DATA subpacket (Code = 7, Subcode = 6) contains information about a system- 
message event: 

SUBPACKET DATA = DISP . NEXT.PACKET ; 

MESSAGE_LEN :WORD ; 

MESSAGE_TEXT : ASCII [80] ; 

END_PACKET ; 

4.6.4.8 Subpackets Declared by DSP8P1 

The following DATA subpacket (Code = 8, Subcode = 2) contains information about an 
unexpected interrupt: 

SUBPACKET DATA = DISP . NEXT.PACKET 

VECT0R_0VER_FOUR :BYTE 

LOST. INT :BYTE 

END_PACKET ; 
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Chapter 5 

Control File Language Guide 

This chapter describes the Control File Language used by the Report Generator of the error 
logging system. 

5. 1 Control File Overview 

The control file for the Report Generator task (RPT) describes the format of the error log file 
and the format of reports based on the file. The actions specified are executed for each event 
to produce a report. The control file specifies the format of the data in an error log packet 
and the output format of the report. In addition, the control file specifies information on the 
accumulation of summary information, how to derive additional information, and the handling 
of selection criteria for reports. 

Control file modules are ASCII text files containing a series of statements written in the Control 
File Language (CFL). The CFL compiler produces intermediate-form modules to be placed in a 
universal library. This library is the control file. 

5. 1 . 1 The Report Generator — General Processing 

The Report Generator is an interpreter for the intermediate-form modules contained in the 
control file. RPT processes control file modules which can, in turn, process error log files. The 
control file module, written in CFL, specifies the processing to be performed on the current 
packet. The processing usually involves calling subroutines from other modules. 

CFL includes primitives that stop packet processing because of an error or because the packet 
does not meet specified selection criteria. 
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5.1.2 The General Format of on Error Log Packet 

The following diagram illustrates how data is organized in a typical error log packet: 



+ + 

I Packet Length | 

+ + 

I Length of Subpacket 1 | 
+ + 

I I 

I Data for Subpacket 1 | 

I I 

+ + 

I Length of Subpacket 2 | 

+ + 

I i 

I Data for Subpacket 2 | 

I I 

+ + 

I I 



+ ^ 

I Length of Subpacket n | 
+ + 

I I 

i Data for Subpacket n | 

I I 

+ + 



Each subpacket contains a different type of data. The information in the subpackets, taken 
together, describes an event logged by the error logging system. The control file contains 
primitives for describing a subpacket so that its contents can be manipulated symbolically. 
Other primitives describe the entire packet as a unit. 

5.1.3 Ttie Control File Language 

CFL is a specialized language designed for this application. It is a statement-oriented, block- 
structured language similar in concept to PASCAL and ALGOL. Unlike BLISS, CFL is not 
expression-oriented; it differentiates between statements and expressions. 

CFL has some of the other capabilities of BLISS, however. For example, expressions can contain 
conditionals. This feature handles the more complex data formats of error log files. CFL does 
not include the full set of prinutives required of an ordinary general-purpose language, but a 
number of specialized primitives speed up and simplify the handling of common error log data 
formats. 
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5.1.4 The General Format of Control File Modules 

Each control file module contains lines of ASCII text. Each line is a sequence of elements, such 
as keywords, variable names, numbers, and operators. Spaces and tabs separate atomic items, 
such as keywords or names. Excess spaces and tabs are ignored and can be used freely for 
formatting. 

You can insert comments in the module text by prefixing them with an exclamation point ( ! ). 
The compiler ignores any text on a line following an exclamation point. 

The three basic elements of CFL are statements, expressions, and declarations, as follows: 

• A statement describes an action. Statements begin with a keyword and are terminated by 
a semicolon (;). 

• An expression describes a computation. Expressions are terminated by any nonexpression 
keyword or by a comma (,). A nonexpression keyword is a keyword that is not valid in an 
expression. Expressions can also be terminated with a semicolon ( ; ). You can also include 
an expression in an expression list, using conditionals to determine whether or not a given 
statement or expression is to be executed. Expression lists consist of a fixed number of 
expressions, separated by commas. 

• A declaration defines the contents of packets and subpackets and defines groups of tables 
for evaluating packets and subpackets. The syntax of a declaration differs for each use. 
Group declarations start with the DECLARE string and end with the END—DECLARE string. 
Table declarations begin with the TABLE string and end with END_TABLE. Dynamic table 
declarations begin with the DYNAMIC-TABLE string and end with END-TABLE. Packet 
and subpacket declarations begin with the PACKET and SUBPACKET strings, respectively, 
and end with END-PACKET. 

6.1.5 Files 

CFL can obtain input from and direct output to any one of a set of files. The files have the 
following internal names: 

INPUT 

The data input file. Data packets are read from the file. The control file can open this file, 
close it, and read packets from it. 

REPORT 

The report output file. Lines of ASCII text are written to this file. The control file can open 
this file, close it, and write ASCII text to it. Automatic paging is available for this file. 

USER 

The user-prompting file. The user can be prompted for input, and input read from this file. 
The control file can open this file, close it, and read ASCII data from this file, with optional 
prompting. 

COMMAND 

The command input file. The user can be prompted for input, and input read from this file. 
The control file can read ASCII data from this file, with optional prompting. 
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ERROR 

The error output file. The control file can write ASCII data to this file. 

5.2 Types and Expressions 

RPT types data to allow easy manipulation of error log information. Expressions describe data 
values used by RPT. This section describes the attributes of supported data types and the format 
of expressions. 

5.2.1 Data Types 

CFL supports the following eight data types: logical, string, numeric, ASCII, field, pointer, 
RSX_TIME, and VMS_TIME. The evaluation of an expression results in a value, which is one 
of the supported data types. The data type of an expression is determined from its context. 

The only automatic conversions are from string values to numeric values, and conversions of 
numeric values between different numeric types and field types. 

The following sections describe the data types in detail. 

5.2.1.1 The LOGICAL Type 

The LOGICAL type expresses the Boolean values true and false. A LOGICAL type is equivalent 
to a BIT type. No other automatic conversions are performed to or from LOGICAL types. You 
express the literal values for this type with the keywords TRUE and FALSE. 

5.2.1.2 The STRING Type 

The STRING type represents strings of binary bytes. Literal values for the STRING type cannot 
be represented. String operations must be used to construct string literals. 

For purposes of conversion, numeric values are considered exactly equivalent to strings. (See 
Section 5.2.1.4.) The length of the string is the number of bytes used to represent a value of 
the numeric type. For example, a WORD is equivalent to a string of length 2. The following 
equivalences are used: 

Type Equivalent String 

BYTE String of length 1 

WORD String of length 2 

LONGWORD String of length 4 

QUADWORD String of length 8 

Strings of length 4 or less are converted to numeric types by appending leading zero bytes to 
form a longword. Strings of length 5 to 8 are converted to numeric types by appending leading 
zero bytes to form a quadword. Strings greater than length 8 are not converted to numeric 
types. 

String declaration requires that you specify the maximum size of the string. The S5mtax for 
string declaration is as follows: 

STRING [size] 
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If the string is a variable, it can contain any number of elements up to and including the 
specified maximum. If the string is part of a data declaration, it contains exactly the number of 
characters specified. 

5.2.1.3 The ASCII Type 

The ASCII type represents character strings. ASCII string literals are represented by character 
strings enclosed in a pair of apostrophes ('string'). Two successive apostrophes in a quoted 
string represent a single apostrophe. Therefore, the string 'ABC'DE' represents the string literal 
ABC'DE. The keyword NULL represents the null string. There is no automatic conversion to 
or from ASCII strings. You cannot use the quotation mark (") to enclose such strings, nor does 
the quotation mark require flagging. 

ASCII string declaration requires specification of the maximum length of the string. Specify the 
maximum string length as follows: 

ASCII [size] 

If the ASCII string is a variable, it can contain any number of characters up to the specified 
maximum. If the ASCII string is a data item, it must contain exactly the number of characters 
specified. 

5.2. 1 .4 Numeric Types 

Numeric data types represent numbers for computation. The numeric types are distinguished 
only by the length of the bit field used to contain the number. A BYTE is a 1-byte field, a 
WORD a 2-byte field, a LONGWORD a 4-byte field, and a QUADWORD an 8-byte field. For 
purposes of conversion, the numeric types are considered equivalent to strings, with the length 
determined by the type. (See Section 5.2.1.2.) 

The special numeric type VALUE indicates a natural machine value. A VALUE is a WORD on 
a PDP-11 processor and a LONGWORD on a VAX processor. 

Numeric types have a default output radix of decimal. The syntax for expressing a numeric 
type is as follows: 

type [option [, . . .]] 

The valid options are radix options and attribute options. The radix options determine the print 
radix. They are DECIMAL, OCTAL, HEX, BCD, BINARY, and RAD50. The attribute options 
are WIDTH and FILL. 

The WIDTH option specifies the print field width and has the following format: 

WIDTH=n 

The FILL option specifies the fill character and has the following format: 

FILL=' character' 
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The default print field width and fill character for each choice of radix are as follows: 



Radix 



Fill 



Print Field Width 







BYTE 


WORD 


LONGWORD Ql 


DECIMAL 


space 


3 


5 


10 20 


OCTAL 


'0' 


3 


6 


11 22 


HEX 


'0' 


2 


4 


8 16 


BCD 


'0' 


2 


4 


8 16 


BINARY 


'0' 


10 


20 


40 80 


RAD50 


space 


N/A 


3 


6 12 



The default radix is DECIMAL. 

As an example, the specification for a LONGWORD to be printed in BCD using leading spaces 
and a field six characters wide is as follows: 

LONGWORD BCD.WIDTH=6,FILL=' ■ 

The special radix MACHINE is the normal radix used to express values for the host machine. 
The MACHINE radix is OCTAL for a PDP-11 processor and HEX for a VAX processor. 

You can express numeric literals in a number of ways. A sequence of digits is, by default, 
interpreted as a VALUE numeric literal. The number is assumed to be decimal. You express a 
numeric literal of a specified type and radix as follows: 

(# type_indicator ' character.string ' ) 

The character string is interpreted according to the specification given by the type indicator. 
The t3rpe indicator is a 1- or 2-character string specifying the type of the number and the radix 
in which to interpret the character string. The first character of the type indicator is the type of 
the number, as follows: 



B 


Byte 


W 


Word 


L 


Longword 


Q 


Quadword 


V 


Value 



The second character of the type indicator is the radix in which to interpret the character string. 
If the radix is not specified, the character string is assumed to be decimal. The valid radix 
indicators are the following: 
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A 


ASCII 


B 


Binary 


D 


Derimal 


I 


Bit value 


O 


Octal 


R 


Radix-50 


X 


Hexadecimal 



A minus sign (-) preceding any character string interpreted as a number indicates the two's 

complement of that number in the indicated radix; that is, binary, octal, decimal, and 

hexadecimal. 

As an example, the following character string represents a byte that contains the octal value 17: 

#B0'17' 

The foUovwng character string represents a word contairung the value -I610: 

#W'-16' 

The bit-value radix indicator specifies that the quoted number is a decimal number representing 
a bit position. The value of the literal is 2 raised to the power of the bit position. 

6.2.1.6 The FIELD Type 

The FIELD type represents a field of numeric types. The BIT type represents a single bit of a 
numeric type and is equivalent to a LOGICAL type. The FIELD type represents a l-or-more-bit 
field of a numeric type and is equivalent to a numeric type. A FIELD type is always a field of 
a numeric variable. There are no literal values for FIELD types. 

The syntax for expressing a BIT type is as follows: 

BITlbit.number] 

The syntax for expressing a FIELD type is as follows: 

FIELD [low_bit .number :field_length in bits] 

In either case, a FIELD type is declared directly following the numeric type of which it is a field. 

6.2.1.6 The POINTER Type 

The POINTER type is a table pointer. You use it to declare variables that temporarily store 
pointers for later use. The POINTER type cannot be converted to or from any other type. There 
is no literal representation of the POINTER type. 

The value of the POINTER type is specific to a given table. A POINTER variable containing a 
value specifpng a table entry for a given table cannot be used to reference an entry in another 
table. The variable can, however, be loaded with another value that references an entry in 
another table. 
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5.2.1.7 The RSX_TIME Type 

The RSX_TIME type represents a time in RSX format. RSX time is represented as six sequential 
bytes containing the year since 1900, the month, day, hour, minute, and second in that order. 
This is a compression of the format returned by the Executive directive GTIM$. 

The RSX —TIME type can only be printed or compared to other RSX —TIME types, or converted 
using one of the %TIM functions. 

5.2.1.8 The VMS_TIME Type 

The VMS—TIME type represents a time in VMS format. VMS time is represented as a quadw^ord 
containing the time in hundreds of nanoseconds since 17 November 1858. 

The VMS— TIME type can only be printed or compared to other VMS— TIME types, or converted 
using one of the %TIM functions. 

5.2.2 Variables 

The named variable is the fundamental unit for data manipulation. Named variables are defined 
in a given module, and available to that module and any modules called by the module. Named 
variables are declared in named groups. The full name of a variable is the name of the group, 
a period ( . ), and the name of the variable in the group, as follows: 

group.name . variable.name 

The group and variable names cannot be more than 15 characters in length. Names can include 
the letters A to Z, the numbers to 9, the dollar sign ($), and the underscore (_). The leading 
character of a name must be alphabetic. You use the same syntax to reference data in either 
packets or subpackets. 

The CFL compiler assigns each variable a type through declarations. (See Section 5.4 for a 
description of the declaration process.) Variables that are not fixed length, such as ASCII and 
STRING type variables, are assigned a maximum length as well. The variable can contain any 
amount of data that fits in its specified maximum length. 

A field in the current record of a table can be referenced in the same manner as a variable, as 
follows: 

table_&ane . f ield.name 

The field value referenced is the specified field in the current record of the table. If there is no 
current record for the table, an error results. 

Several special variables provide information about a group, packet, subpacket, or table. You 
reference the special variables in the following format: 

group, [sub] packet or table_name . 8pecial_variable_name 

The special variables are described as follows: 
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LENGTH 

The length of the data in the group in addressable units of the host machine (bytes for 
PDP-11 and VAX processors). LENGTH includes all repetitions for repeated data or records 
for tables. 

POINTER 

Returns the current pointer for the specified group. POINTER is not valid for any data 
structure that would not have a current record context. This includes variables and non- 
repeated data. There is a current record context for tables and repeated data. 

CONTEXT 

Returns a logical value. If the specified group has a current record context, the value is set 
to true. If the specified group has no current record context, the value is set to false. 

COUNT 

Returns a numeric value representing the number of records in a group. For groups of 
variables, the value is alv*:ays 1. For packets or subpackets, the value is the number of 
repetitions of the data. For tables, it is the number of records in the table. 

5.2.3 Literals 

Literal values can be assigned symbolic names. These symbolic names have the same syntax 
restrictions as variable names. Literal names are considered equivalent to their values in 
expressions. See Section 5.6.2 for information on the LITERAL statement. 

5.2.4 Expressions 

Expressions describe a computation through a sequence of operands and operators. Operands 
are variables or literals. Operators direct the computation. Expression evaluation is from left to 
right, and operator precedence is observed. Use open parentheses ( ( ) and close parentheses ( ) ) 
to override precedence. 

Operators are either unary, which means that they take one operand, or binary, which means 
that they take two operands. Unary operators that precede the operand are called prefix 
operators; when they succeed the operand, they are called suffix operators. Binary operators 
are always specified between the two operands. 

Operators are type-specific; that is, they operate between two elements of a specific type to 
produce a result of a specific type. The elements of an expression can be any of the following 
kinds: 

literals 

Literals express fixed values of a given type. 

variables 

Variables reference previously computed values. 

(subexpressions) 

Any valid expression enclosed in parentheses can be used as an element to an operator. 
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functions 

A function is a predefined computation. (See Section 5.3.) 

The following sections describe the various operators. 

5.2.4.1 String Operators 

String operators produce either binary or ASCII string results. The result is a string with the 
same type as the operand string or strings. The string operators are as follows; 

• String concatenation ( I ) binary operator 

The string concatenation operator concatenates the first operand with the second. Both 
strings must be of the same type, as in the following expression: 

'ABC I 'DEF' 

This expression produces the following string: 

'ABCDEF' 

• Substring extraction (n:m) unary suffix operator 

The substring extraction operator produces the string formed by character n and the next 
m elements. String element numbers start with 1. For example, consider the following 
expression: 

'ABCDEFGH'<4:3> 

This expression produces the following string: 

'DEF" 

CFL treats both n and m as word values. 

• Element extraction (n) unary suffix operator 

The element extraction operator is a special case of the substring extraction operator. It 
extracts the nth element as a single-character substring. For example, consider the following 
expression: 

'ABCDEFGH'<4> 

This expression produces the following string: 
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5.2.4.2 Logical Operators 

Logical operators perform operations on logical variables, or compare string or numeric variables 
to yield logical results. 

The logical operators are as follows: 

• Logical AND binary operator 

The logical AND operator does a logical AND of the two expressions. For example, the 
following expression produces the logical value false: 

TRUE AND FALSE 

• Logical OR binary operator 

The logical OR operator does a logical OR of the two expressions. For example, the 
following expression produces the logical value true: 

TRUE OR FALSE 

• Logical exclusive-OR (XOR) binary operator 

The logical exclusive-OR operator does a logical exclusive-OR of the two expressions. For 
example, the following expression produces the logical value false: 

TRUE XOR TRUE 

• Logical NOT unary prefix operator 

The logical NOT operator produces the logical complement of a single variable. For example, 
the following expression produces the logical value false: 

NOT TRUE 

• Bit extraction ([n]) unary suffix operator 

The bit extraction operator produces a logical result from numeric expressions. It is set 
to true if and only if bit n of the longword expression operand is set. For example, the 
following expression produces the logical value false: 

#W0'3O5' [4] 

The binary value of octal 305 is 011000110, with the fourth bit clear. Bits are numbered 
from 0. 

5.2.4.3 Relational Operators 

Relational operators compare string, time, or numeric operands. The comparisons are string 
comparisons if both operands are string or ASCII string operands. The comparisons are numeric 
comparisons if one operand is numeric and the other is either numeric or string. You cannot 
compare ASCII string operands and numeric operands. The comparisons are time comparisons 
if both operands are times of the same type. You cannot compare different types of time. 

In numeric comparisons, the larger numeric value is greater. 
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In string comparisons, CFL stops at the first two characters that do not match and performs an 
ASCII sort. That is, CFL compares the ASCII values of the characters. 

Note 

Although Z is greater than A in ASCII, an ASCII sort is not the same as an 
alphabetic sort. Any lowercase letter has greater value than any uppercase letter, 
for instance, but any alphabetic character has greater value than any numeric 
character, and so forth. 

If one string is longer than the other and the shorter string has the same leading elements as 
the longer, the longer string is greater. 

In time comparisons, later times are greater. 

The relational operators are as follows: 

• Equality binary operator 

The equality (EQ) operator is set to true if and only if the operands are equal. For example, 
the following expression produces the logical value false: 

#WD'123' EQ #WD'355' 

• Inequality binary operator 

The inequality (NE) operator is set to true if and only if the operands are not equal. For 
example, the following expression produces the logical value true: 

'ABCDEF' NE 'ABC 

• Greater-than binary operator 

The greater-than (GT) operator is set to true if and only if the first operand is greater than 
the second operand. For example, the following expression produces the logical value false: 

123 GT 355 

• Less-than binary operator 

The less-than (LT) operator is set to true if and only if the first operand is less than the 
second operand. For example, the following expression produces the logical value true: 

'ABCDEF' LT 'ABCZZZ' 

• Greater-than-or-equal binary operator 

The greater-than-or-equal (GE) operator is set to true if and only if the first operand is greater 
than or equal to the second operand. For example, the following expression produces the 
logical value true: 

45 GE 45 

• Less-than-or-equal binary operator 

The less-than-or-equal (LE) operator is set to true if and only if the first operand is less than 
or equal to the second operand. For example, the following expression produces the logical 
value false: 

'Z' LE 'A' 
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• String-matching binary operator 

The string-matching (MATCH) operator compares strings. The strings are examined to 
determine which is shorter. The shorter string is compared character-by-character to the 
longer string. If all characters in the shorter string match with characters in the longer 
string, then the strings are equal and the value is set to true. This means a null string 
always matches any other string. For example, the following expression produces the logical 
value true: 

'ABCDEF' MATCH 'AB' 

The following expression produces the logical value false: 

•ABCDEF' MATCH 'ABCX' 

5.2.4.4 Numeric Operators 

Numeric operators operate on numeric variables as unsigned longwords. The numeric operators 
are as follows: 

• Field extraction suffix unary operator 

The field extraction ([n:m]) operator produces the longword formed by taking the m-bit 
field beginning at bit n in the longword. Bit positions are numbered from least significant 
to most significant, beginning with 0. For example, the following expression produces the 
octal value 35: 

#WD'357' [3:6] 

Octal 357 has the binary value 011101111. Bit 3 and the next six bits have the binary value 
011101, or octal 35. 

• Logical SHIFT binary operator 

The logical SHIFT operatoir produces the first operand shifted by the number of bit positions 
specified by the second operand. Each left shift of one bit is the equivalent of multiplying 
by 2 and each right shift of one bit is the equivalent of dividing by 2. Indicate a left shift 
by making the second operand positive, and a right shift by making the second operand 
negative. If the second operand is zero, nothing shifts. The shifting is logical shifting; there 
is no sign extension on right shifts. 

For example, the following expression produces decimal 820, which is decimal 205 multiplied 
by 4: 

#WD'205' SHIFT 2 

• Multiplication binary operator 

The multiplication (*) operator produces the product of the two operands. The result of 
the multiplication is truncated to the 32 low-order bits. 

For example, the following expression produces the decimal value 15: 

5*3 

• Division binary operator 



Control File Language Guide 5-13 



The division ( / ) operator produces the integer quotient of the two operands. For example, 
the following expression produces the decimal value 7: 

15 / #B'2* 

• Modulus binary operator 

The modulus (MOD) operator produces the remainder of the integer division of the two 
operands. For example, the following expression produces the decimal value 1: 

15 MOD 2 

A division or modulus operation with zero as the divisor causes an error. 

• Addition binary operator 

The addition ( + ) operator produces the sum of the two operands. The sum is truncated to 
the 32 low-order bits. For example, the following expression produces the decimal value 
17: 

5 + 12 

• Subtraction binary operator 

The subtraction ( - ) operator, or minus sign, produces the difference of the two operands. 
The difference is truncated to the 32 low-order bits. For example, the following expression 
produces the decimal value 9: 

12-3 

• Negation unary prefix operator 

The negation ( - ) operator, or minus sign, produces the two's complement of the operand. 
For example, the following expression produces the decimal value -8: 

- #B'8' 

The minus sign is both a unary and binary operator. 

5.2.4.5 Bitwise Logical Operators 

The bitwise numeric operators perform bitwise logical operations between two numeric operands. 
Rather than comparing the numeric operands as numbers, these operators compare the numeric 
operators bit by bit. 

The bitwise logical operators are as follows: 

• Bitwise AND binary operator 

The bitwise AND operator produces the bitwise logical AND of the two operands. For 
example, the following expression produces the octal value 1: 

#B0'41' AND #B0'3' 

The binary value of octal 41 is 00100001 and the binary value of octal 3 is 00000011. The 
bitwise AND operation determines that the least significant bit is set in both operands and 
returns the binary value 0000001, or octal 1. 

• Bitwise OR binary operator 
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The bitwise OR operator produces the bitwise logical OR of the two operands. For example, 
the followii\g expression produces the octal value 43: 

#B0'41' OR #B0'3' 

The bitwise OR of the binary values returns the binary value 00100011, or octal 43. 

• Bitwise exclusive-OR (XOR) binary operator 

The bitwise XOR operator produces the bitwise logical exclusive-OR of the two operands. 
For example, the following expression produces the octal value 42: 

#B0'41' XOR #B0'3' 

The bitwise exclusive-OR of the binary values returns the binary value 00100010, or octal 
42. 

• Bitwise complement unary operator 

The bitwise complement (NOT) operator produces the bitwise complement (logical negation) 
of the operand. For example, the following expression produces the octal value 336: 

NOT #B0'41' 

The binary value of octal 41 is 00100001 and its comp-sment is 11011110, or octal 3360. 

5.2.5 Operator Precedence 

Operations occur in the order defined by operator precedence unless overridden by parentheses. 
Operator precedence in CFL is the same as in most other languages (such as FORTRAN). 
Operators with higher precedence are evaluated before operators with lower precedence. For 
example, the following expression is evaluated as A + (B • C): 

A + B * C 

The expression is not evaluated as (A + B) * C because the multiplication operator (*) has 
higher precedence than the addition operator (+). In general, expressions are evaluated from 
left to right, taking into account operator precedence unless overridden by parentheses. 

Operators are classified in the categories shown in the following table, and are listed in order 
of decreasing precedence. (The order in which operators are listed within a category is not 
significant.) 



Highest 
Precedence Class 


Prefix/Suffix Unary Operators 


- 


Numeric negation 


NOT 


Logical or numeric bitwise negation 


[n:m] 


Numeric field extraction 


[n] 


Logical value extraction 


<n:m> 


Substring extraction 


<n> 


Element extraction 
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Multiplication 
Precedence Class 



Numeric Binary Operators 



/ 

SfflFT 

MOD 



Numeric multiplication 
Numeric division 
Numeric logical shifting 
Ntimeric modulus 





Addition 
Precedence Class 


Numeric Binary Operators 


+ 


Numeric addition 
Numeric subtraction 




Logical 
Operation Class 


Logical/Bitwise Logical Operators 



AND 

OR 

XOR 



Logical and bitwise logical AND 
Logical and bitwise logical OR 
Logical and bitwise logical XOR 



Relational 
Class 



Logical Comparison Operators 



EQ 

NE 
GT 
GE 
LT 
LE 



Equality 

Inequality 

Greater than 

Greater than or equal to 

Less than 

Less than or equal to 



5.3 Functions 

Functions provide special computations or special values not otherwise available to a program 
written in CFL. 

A reference to a function in an expression has the following format: 

Xf unction [ (argument [=Talue] [,...] ) ] 



5-16 Control File Language Guide 



Function names have the format %class name$function name. Some functions require 
arguments. Note that the parentheses are a required part of the syntax when arguments are 
specified. Functions return a value of a type that is fixed for a given function. For example, the 
following function returns the identification code of the current data packet as an ASCII string: 

•/.PKT$IDENT 

The following sections list the CFL functions by class name. The listings show the required 
syntax and are followed by descriptions of the values they return. 

5.3.1 %CND Functions — Conditional Functions 

The %CND functions select one of a set of expressions for evaluation. You can state criteria to 
select one of the arguments to be evaluated in a given context. 

Note 

All expressions are evaluated before determining a result. This means all 
expressions must be valid for any possible value of the logical expression. That 
is, %CND$IF is not entirely equivalent to an IF-THEN-ELSE statement, and 
%CND$SELECT is not entirely equivalent to a SELECT statement. 

The %CND functions are as follows: 

%CND$IF(logical, true exp, false exp) 

This function evaluates the specified logical expression. If the expression is true, the true 
expression is returned as the value of the function. If the expression is false, the false 
expression is returned as the value of the function. 

%CND$SELECT(selector, exp else, exp 0, [exp 1 ,...]) 

This function evaluates the specified selector expression. If the value of the expression is 0, 
the exp expression is returned as the value of the function. If the value of the expression 
is 1, the exp 1 expression is returned as the value of the function. In general, if the value 
of the selector expression is n, the value of exp n is returned as the value of the expression. 
If no expression is provided corresponding to the value of the selector expression, the value 
of exp else is returned as the value of the expression. 

5.3.2 %CNV Functions — Conversion Functions 

The %CNV functions convert expressions to ASCII strings, primarily for printing. The 
conversions allow specification of the output radix, leading fill character (if any), and number 
of digits converted. 
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5.3.2.1 %CNV Functions — Numeric Conversion Functions 

The numeric conversion functions convert numeric values to ASCII strings in the radix of the 
specific function. The syntax of these functions is as foUow^s: 

XCNV$xxx(numeric_value [,field_width [.f ill_character]]) 

In this format, xxx is the radix. If no field width is specified, the default is 0. If no fill character 
is specified, the default is the null character. The field width and the fill character control the 
length of the returned string and justification of the digits in the string. 

The numeric conversion functions behave as follows: CFL converts the numeric value to an 
ASCII string using the appropriate radix, and calculates the number of resulting digits. The 
following algorithm formats the returned string: 

if field.width = then 

return a string of length mimber_of_digit8 containing only the 
converted digits 

else 

if number_of_digit8 > field_width then 

return a string of length field.width filled with asterisks 

else 

if fill_character = null_character then 

return a string of length field.width with the digits left 
justified and pad the string with trailing blanks 

else 

return a string of length field_width with the digits right 
justified preceded by the specified f ill_character 

The numeric conversion functions are as follows: 

%CNV$OCTAL(numeric value[,fleld width[,till character]]) 

Converts the number from binary to ASCII octal representation. 

%CNV$DECIMAL(numeric value[,lleld width[,flll character]]) 

Converts the number from binary to ASCII decimal representation. 

%CNV$DECIMAL_P(numeric volue[,field width[,flll character]]) 

This function is identical to the %CNV$DECIMAL function, except that it appends a decimal 
point to the end of the output ASCII string. The decimal point is not counted in the field 
width. 

%CNV$HEX(numeric value[,fleld width[,flll character]]) 

Converts the number from binary to ASCII hexadecimal representation. 

%CNV$BCD(numeric value[,field width[,tlll character]]) 

This function is identical to the %CNV$HEX function. It converts the number from binary 
to ASCII hexadecimal representation. 

%CNV$BINARY(numeric value[,fleld wldth[.flll character]]) 

Converts the number from binary to ASCII binary representation. 



5-18 Control File Language Guide 



%CNV$MACHINE(numeric value[,fleld width[,fill character]]} 

Converts the number from binary to ASCII representation in the natural machine radix, 
which is octal for a PDP-11 processor and hexadecimal for a VAX processor. 

%CNV$RAD50(numeric value[,fleld width[,fill character]]) 

Converts a numeric t5^e to an ASCII string using Radix-50 conversion. The numeric value 
must be a word, longword, or quadword. 

5.3.2.2 %CNV Functions — Miscellaneous Conversion Functions 

The following miscellaneous conversion functions are available: 

%CNV$STRING(strlng) 

Performs a hexadecimal conversion of the specified string to ASCII. 

%CNV$RSX_TIIV1E(RSX_time_value[,flelds]) 

Converts the RSX time value to a string in the format yy-mmm-dd hh:mm:ss. The optional 
fields parameter specifies the number of fields of the date to be converted. To convert only 
the date, specify 3. To convert the date and time (excluding the seconds), specify 5. The 
default is the full date and time expressed in six fields. 

%CNV$VMS_TlME(VMS_time_value[,flelds]) 

Converts the VMS time value to a string in the format yy-mmm-dd hh:mm:ss. The optional 
fields parameter specifies the number of fields of the date to be converted. To convert only 
the date, specify 3. To convert the date and time (excluding the seconds), specify 5. The 
default is the full date and time expressed in six fields. 

6.3.3 %COD Functions — Encoding Functions 

The encoding functions convert ASCII strings into numeric values, using different radixes. The 
encoding functions are as follows: 

%COD$OCTAL(string) 

Converts the string to a value using octal radix. The string may contain only the digits to 
7 and optional leading spaces or the minus sign ( - ). 

%COD$DECIMAL(string) 

Converts the string to a value using decimal radix. The string may contain only the digits 
to 9 and optional leading spaces or the minus sign ( - ). 

%COD$HEX(string) 

Converts the string to a value using hexadecimal radix. The string may contain only the 
digits to 9, the letters A through E, and optional leading spaces or the minus sign ( - ). 

%COD$BCD(sfring) 

Same as %COD$HEX. Converts the string to a value using hexadecimal radix. The string 
may contain only the digits to 9, the letters A through E, and optional leading spaces or 
the minus sign (-). 
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%COD$BINARY(string) 

Converts the string to a value using binary radix. The string may contain only the digits 
and 1, and optional leading spaces or the minus sign (-). 

%COD$MACHINE(string) 

Converts the string to a value using the natural radix for MACHINE, which is octal for a 
PDP-11 processor and HEX for a VAX processor. 

%COD$RSX_TIME(string) 

Converts the string to a date in RSX format. The string must be of the form dd-mmm-yy 
[hh:mm[:ss]]. The date and time can occur in either order; the seconds (:ss) are optional. 
The default for the time fields is 00:00:00. 

%COD$VMS_TIME(string) 

Converts the string to a date in VMS format. The string must be of the form dd-mmm-yy 
hh:mm:ss. The date and time can occur in either order; the seconds (:ss) are optional. 

6.3.4 %COM Functions — Computational Functions 

The computational functions are as follows: 

%COM$AND(numeric expression, numeric expression) 

Returns the logical AND of the two numeric expressions. Both expressions must be 
machine values or shorter. This function is used primarily for overlay reasons on the 
PDP-11 processor. 

%COIVI$HARDWARE(numeric expression) 

Returns the ASCII character corresponding to the numeric expression in the DIGITAL 
hardware alphabet, which is ABCDEFHJKLMNPRSTUV, numbered from to 17. For 
example, %COM$HARDWARE(0) returns an A. 

%COM$LONGWORD(value,bit [.vaiue.bit [,...]]) 

Returns a longword value. Each value is shifted by the specified number of bits and then 
the logical OR of all the values is returned. 

%COIVI$NEGATE(value) 

Returns the negative of the specified value. This is the two's complement of the value. 

%COi\/l$NULL(expression) 

Returns a true value if the result of the expression is a value of length zero, or a false value 
if the result of the expression is a value vdth length other than zero. 

5.3.5 %CTL Functions — RPT Control Functions 

The RPT control functions are as follows: 
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%CTL$OPEN(flle.(llespec,default_spec) 

Opens the file using the file specification and the default file specification. The value of the 
function is the fully qualified file specification for the file. 

%CTL$STATUS(flle) 

Returns the value set to true if the file is open and set to false if the file is not open. 

%CTL$FILE_STATUS 

Returns the numeric status value returned by the file system after the last file-open operation. 

%CTL$EOF(llie) 

Returns the value set to true if the specified file is at end-of-file (EOF), or set to false if the 
file is not at EOF. 

%CTL$CLOSE(flle) 

Closes the file. The value of the function is the number of records written to the file. 

%CTL$INPUT(low,hlgh) 

Sets the lowest and highest packets to be processed by RPT. Returns a true value if both 
packet specifications are syntactically correct, and a false value if neither is syntactically 
correct. 

This implicitly sets the processing direction as well because, if the high packet is lower 
than the low packet, the file is processed backwards. A null packet specification takes the 
default: the beginning of the file for the low packet and the end of the file for the high 
packet. 

5.3.6 %LOK Functions — Look-Ahead Functions 

The %LOK functions obtain information in undeclared data packets or subpackets. There is a 
%LOK function for each of the data types supported for look-ahead operations. All offsets are 
byte offsets. The %LOK functions are as follows: 

%LOK$BYTE(subpacket_number,offset) 

Returns the specified byte from the current data packet. The subpacket number is the 
number of the subpacket from which the data is to be obtained. If the subpacket number is 
0, the data is obtained fi-om the packet itself. The offset is the byte offset in the subpacket 
for the data item. 

%LOK$WORD(subpacket_number,offset) 

Returns the specified word from the current data packet. The subpacket number is the 
number of the subpacket firom which the data is to be obtained. If the subpacket number is 
0, the data is obtained from the packet itself. The offset is the byte offset in the subpacket 
for the data item. 

%LOK$LONGWORD(subpacket_number,offset) 

Returns the specified longword from the current data packet. The subpacket number is the 
number of the subpacket from which the data is to be obtained. If the subpacket number is 
0, the data is obtained from the packet itself. The offset is the byte offset in the subpacket 
for the data item. 
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%LOK$LENGTH(subpacket_number) 

Returns the length of the data in the specified subpacket. The subpacket number is the 
number of the subpacket whose length is to be returned. If the subpacket number is 0, the 
length of the data packet is returned. 

5.3.7 %PKT Functions — Packet Intormation Functions 

The following %PKT functions obtain information about the current packet: 

%PKT$MODULE(module_name) 

Returns the value true if the specified module exists in the control file, and false if it does 
not exist. 

%PKT$IDENT 

Attempts to get the next packet from the input file in the range specified by %CTL$INPUT 
and makes it the current packet. If no more packets exist within that range, a null 
string is returned. Otherwise, %PKT$IDENT returns the current packet identification as a 
fixed-length ASCII string of eight characters. 

6.3.8 %RPT Functions — Report Controi Functions 

The following %RPT functions control report generation: 

%RPT$PAGE_SIZE(lines) 

The default page size is 57 w lines of text plus headers and a form feed. %RPT$PAGE_SIZE 
changes the number of lines per page to the specified value. If the value is 0, the page size 
is infinite. The function returns the previous number of lines per page before the function 
was executed. 

%RPT$PAGE_DEFAULT 

Returns the default number of lines per page of RPT, which is 57io. 

7oRPTSPAGE_CURRENT 

Returns the current number of lines per page. 

%RPT$PAGE_REMAINING 

Returns the number of lines remaining on the current page. 

%RPT$LINE_SKIP(interval, lines) 

Causes RPT to skip the specified number of lines for every interval number of lines. If 
the interval is 0, automatic line skipping is suppressed. The function value is the previous 
interval. 

%RPT$LINE_REMA1NING 

Returns the number of lines remaining in the current interval. 

%RPT$COMMAND 

Returns the command line as a string. 

%RPT$1DENT 

Returns the RPT identification as a string. 
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%RPT$STATUS(status> 

Sets the exit status of RPT to the specified status value if it is more severe than the current 
exit status. If it is not more severe, no action is taken. The actual status value is determined 
by the control files using this function, based on the value given by the status argument. A 
status value is considered a SUCCESS, or true, status if the low bit is 1, and a FAILURE, 
or false, status if the low^ bit is 0. 

The foUowdng algorithm, where NEW—STATUS is the value of the status argument and 
EXIT—STATUS is the current exit status, is used to update the exit status: 

IF NEW.STATUS 
THEN 

BEGIN 

IF EXIT.STATUS AND ( NEW_STATUS GT EXIT.STATUS ) 

THEN 

SET EXIT.STATUS TO NEW.STATUS ; 
END ; 
ELSE 

BEGIN 

IF EXIT.STATUS OR ( NEW.STATUS GT EXIT.STATUS ) 

THEN 

SET EXIT.STATUS TO NEW.STATUS 
END : 

The function returns the original value of EXIT—STATUS rather than the potentially updated 
EXIT-STATUS. 

5.3.9 %STR Functions — String-Handling Functions 

The following %STR functions manipulate ASCII and binary strings: 

%STR$TRAIL(string,element) 

Removes all trailing repetitions of the specified element from the specified string. The value 
of the function is the original string without the trailing characters. 

%STR$LENGTH(string) 

Returns the length of the specified string as a numeric value. 

%STR$PARSE(string,pointer,control) 

Performs a simple parse by returning a pointer to the end of the substring, beginning at 
the specified pointer position in the string and terminated by any of the characters in the 
control string or by the end of the string. 

%STR$QUOTE(string,pointer.control,quote) 

Performs a simple parse with quote characters. STR$QUOTE works the same way as 
STR$PARSE except that STR$QUOTE handles quote characters. The quote argument is a 
character string of two characters. For clarity, the two characters should match in some 
way, but this is not required. If the first character of the pair is encountered, checking for 
control characters stops until the second character of the pair appears. For example, the 
quote string ' <> ' causes anything between a left angle bracket ( < ) and a right angle 
bracket ( > ) to be considered as "quoted" and treated as a unit. 
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%STR$REMAINING(string,pointer) 

Returns the substring of the specified string consisting of all characters including and 
following the specified pointer position. 

%STR$MATCH<string,string) 

Performs an element-by-element comparison of the two strings. The comparison continues 
only as long as there are elements to compare. That is, with strings of different lengths, 
the comparison stops with the last element in the shorter string. %STR$MATCH returns a 
value set to true if the elements match, and false if they do not. 

%STR$SEARCH(string,pointer,string) 

Searches the first string, beginning at the specified pointer position, for the second string. 
The pointer returns to the position in the first string at which the second string begins. If 
the second string is not found, %STR$SEARCH returns a zero. 

%STR$PAD(string,paddingstring,lead,trail) 

Creates a new string consisting of the specified string padded with the single-character 
padding string. The lead and trail numeric expressions specify how many padding characters 
you want to lead or trail the original string. 

%STRSFILE(string, pointer) 

Assumes the pointer is at the beginning of the file specification. It returns a pointer to 
the character following the file specification. If the string pointed to is not a valid file 
specification, %STR$FILE returns a zero. 

%STR$UPCASE(value) 

Returns the specified string with all lowercase letters converted to uppercase. 

%STR$CHAR(value) 

Returns the character corresponding to the specified value. 

5.3.10 %TIM Functions — Time-Handling Functions 

The %TIM functions manipulate times. The time values include both date and time unless 
otherwise noted. The RSX and VMS %TIM functions are as follows: 

RSX Time Functions 

%TIM$RSX_CURRENT 

Returns the current date and time as a value in RSX format. 

7oTIM$RSX_DATE(RSX_time_value) 

Returns the date only in RSX format. 

%TIM$RSX_VMS(VMS_time) 

Returns an RSX time value corresponding to the specified VMS time. 

%TIM$RSX_NULL 

Returns a null RSX time value. This value prints as all blank spaces. 
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VMS Time Functions 

%TIM$VMS_CURRENT 

Returns the current date and time as a value in VMS format. 

%TIM$VMS_DATE(VMS_time_value) 

Returns the date only in VMS format. 

%TIM$VMS_PLUS(VMS_time,days) 

Returns a VMS time value containing the specified time plus the specified number of days. 

%TIM$VMS^MINUS(VMS_time,days) 

Returns a VMS time value containing the specified time minus the specified number of days. 

%TIM$VMS_RSX(RSX_tlme) 

Returns a VMS time value corresponding to the specified RSX time. 

%TIM$VMS_NULL 

Returns a null VMS time value. This value prints as all blank spaces. 

5.3.11 The %USR Function — User I/O Function 

The %USR function performs input and output to and from the user of RPT, as follows: 

7oUSR$STRING(flie, prompt, maximum-length) 

Writes out the prompt string if the specified file is a terminal, and reads a string input 
whose maximum length is specified by the length parameter. If the specified output file is 
not a terminal, there is no prompt and only the read is performed. 

5.4 Declarations 

This section describes the declaration of variables and data items. A declaration includes print- 
formatting information along with the definition of data items; it is different from declarations 
in most languages. 

5.4. 1 Scope of Declarations 

Data items can be referred to during the scope of the declaration; that is, from the point they 
are declared until the declaration is discarded. If a declaration is made in a given procedure, 
data items can be referenced in the defining procedure or any procedure called by it. 

5.4.2 Thie DECLARE Statement 

The DECLARE statement begins the declaration of a block of variables. The format of the 
DECLARE statement is as follows: 

DECLARE group name [ NAMED ] 



variable.name 


: type [: print.expressions] 


variable_name 


: type [: print.expreasions] 


variable.name 


: type [: print.expressions] 


END.DECLARE ; 
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group name 

The group name is the prefix name by which the DECLARE statement identifies the group 
variables. The name of each group variable is in the following format: 

group_name . variable.name 

type 

The variable tj^e is one of the RPT data types: LOGICAL, STRING, ASCII, NUMERIC, 
FIELD, RSX_TIME, or VMS_TIME. 

NAMED 

The optional NAMED qualifier specifies that the symbol names are to be kept and used 
with the WRITE —GROUP statement FORMAT clause qualifiers that print a symbol name. 

print-expressions 

The optional print expressions specify expressions to be evaluated and printed if the group 
is printed using the WRITE— GROUP statement. If you specify more than one expression, 
separate them by commas. 

The print iriformation consists of one or more expressions separated by commas. If the 
WRITE— GROUP statement is used to print the data group, the print expressions are 
evaluated and printed. 

Declaration of a numeric type can be followed by declaration of one or more field types. 
The field types are considered fields of the preceding numeric type declaration. 

Print information for field types is handled specially. The variable names for field types 
do not appear when the WRITE— GROUP statement is used, and the print expressions 
following a field type declaration are considered to apply to the preceding numeric type. 
Of the print expressions following a field type, one is selected based on the field value. 

For BIT fields, the first print expression is used if the BIT is set to true, and the second if 
the BIT is set to false. 

For FIELD fields, the first print expression is used if no other print expression applies. The 
second print expression is used if the FIELD value is 0, the third if the FIELD value is 1, 
the fourth if the FIELD value is 2, and so on. 

When a print expression is printed for a field t3^e, it is printed in the following format: 

p[h:l] (t[...]) 

Parameters 

p The leading character of the print expression. This appears as a prefix to the print 

field. 

h The high-bit number of the FIELD, or the bit number of the BIT field. The square 

brackets are printed. 

1 The low-bit number of the FIELD. The "1" field and the leading colon are printed 

as blanks for BIT fields. 
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t The trailing characters of the print expression. The trailing characters are any 

characters following the first character. 

The following example illustrates a print expression: 

DECLARE EXAMPLE : 

VARIABLE. 1 : WORD : 

: FIELD [6:2] : '*The value of this field is 2 or 3', 

• The value of this field is 0' , 

' The value of this field is 1' ; 

When EXAMPLE is printed with a WRITE_GROUP statement, the field will be printed as 
follows, depending on whether bits 6 and 7 contain the value 0, 1, 2, or 3: 

[ 7: 6] The value of this field is 

[7:6] The value of this field is 1 

*[ 7: 6] The value of this field is 2 or 3 

Note 

The field is declared in the form [6:2], meaning that it starts at bit 6 and 
is 2 bits long. However, the print format is expressed in the form [ 7: 6], 
meaning that it consists of bits 6 and 7. 

5.4.3 The PACKET Statement 

The PACKET statement declares an input data packet. The format is as follows: 

PACKET name [ REPEATED ] [ NAMED ] ; 

name : type : print_information ; 

name : type : print_information ; 

name : type : print_information ; 
END.PACKET ; 

The REPEATED data attribute is optional. A PACKET statement without this attribute specifies 
a single packet. The REPEATED attribute specifies that the data in the packet is repeated. The 
number of repetitions is computed by dividing the packet length by the length of the data items. 
Note that the items must be referenced as for a DYNAMIC—TABLE statement; they cannot be 
referenced directly. 

The optional NAMED qualifier specifies that the symbol names are to be kept and used with 
the WRITE —GROUP statement FORMAT clause qualifiers that print a symbol name. 

The declaration of data defines the special variable LENGTH, referenced as the data items 
themselves would be referenced, as follows: 

data_group_name . LENGTH 

Note that the length can be referenced directly, even for a REPEATED data group. 

Each of the data item names is declared, along with the type and print information. The name 
is the name by which the data element is referenced. 

The format for a data element reference is as follows: 

data_group_name . data_element_name 

The data item t3?pe is declared as specified in Section 5.2. L 
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The special variable name RESERVED in place of an element declaration specifies a sequence of 
undefined values. The type declaration specifies the length of the undefined area. This cannot 
be a field type. The s)mtax is as follows: 

PACKET name data organization ; 

name : type : print_information ; 

RESERVED : type ; 

name : type : print_information ; 
END.PACKET ; 

A RESERVED declaration in a PACKET or SUBPACKET statement indicates to the compiler 
(and RPT) that the area is currently unused, but to use its length in determining the size of the 
packet or subpacket and the offsets of elements following the RESERVED declaration. You use 
RESERVED either to reserve space for future use or to force word-boundary alignments. 

Note that an element name could be used in these situations, but that RESERVED serves as 
a documentation aid and saves having to define unique element names if there are multiple 
unused areas in a packet or subpacket. 

5.4.4 The SUBPACKET Statement 

The SUBPACKET statement declares an input data subpacket. The format is as follows: 
SUBPACKET name = expression <data attribute> [ NAMED ] ; 



name 
name 
name 
END_PACKET ; 



type [ 
type [ 
type [ 



print_information] 
print_infoniiation] 
print_in£ormation] 



The attribute, if present, is REPEATED. A SUBPACKET statement without an attribute specifies 
a single subpacket. The leading REPEATED attribute specifies that the data in the subpacket 
is repeated. The number of repetitions is computed by dividing the subpacket length by the 
length of the data items. Note that the items must be referenced as for a DYNAMIC—TABLE 
statement; they cannot be referenced directly. 

The optional NAMED qualifier specifies that the symbol names are kept and used with the 
WRITE_GROUP statement FORMAT clause qualifiers that print a symbol name. 

The handling of a SUBPACKET statement is otherwise the same as for a PACKET statement. 

5.4.5 Conditional Declarations 

RPT provides a mechanism for the conditional declaration of data items. Conditional declaration 
can only be used for data; that is, PACICET and SUBPACKET declarations. FIELD and BIT 
declarations cannot cross conditionals. All FIELD and BIT declarations must be in the same 
conditional as their data item. 

The conditionals allowed in declarations are as follows: 

• IF has the following syntax: 
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name 
name 
name 



type [: print_information] 
type [: print.information] 
type [: print.information] 



IF expression 

THEN 

BEGIN 

name 

name 

name 

END 



ELSE 



type [: print_inlormation] 
type [: print_information] 
type [: print_information] 



BEGIN 

name : 
name : 
name : 
END 



type [: print_inf ormation] 
type [: print_inf ormation] 
type [: print_inf ormation] 



END_IF 



name : type [: print_inf ormation] 
name : type [: print_inJormation] 
name : type [: print_inf ormation] 

If the expression is set to true, the THEN clause is defined. If the expression is set to false, 
the ELSE clause is defined. The ELSE clause is optional. 

CASE has the following syntax: 

name : type [: print_inf ormation] 
name : type [: print_inf ormation] 
name : type [: print_inf ormation] 

CASE expression OF 

[expression [....]] : 



BEGIN 

name 

name 

name 

END 



type [: print_inf ormation] 
type [: print.inf ormation] 
type [: print_inf ormation] 



[ expression [,...]] 



BEGIN 

name 

name 

name 

END 



type [: print_inf ormation] 
type [: print_inf ormation] 
type [: print_inf ormation] 



[expression , expression 



] 



BEGIN 

name 

name 

name 

END 



type [: print.inlormation] 
type [: print_inf ormation] 
type [: print_inf ormation] 



ELSE 
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BEGIN 

name 

name 

name 

END 



type [ 
type [ 
type [ 



print_information] 
print_information] 
print_information] 



END_CASE ; 

name : type [ 
name : type [ 
name : type [ 



print_information] 
print_inf ormation] 
pr int_inf ormat i on] 



The expression in the CASE statement is evaluated and the expression lists searched to find 
a matching expression value. If a match is found, the declaration is made. If no matching 
expression value is found, the optional ELSE clause is executed. Otherwise, an error occurs. 

5.5 Action Statements 

Action statements perform processing. CFL has a limited set of action statements because it is a 
simple, special-purpose language. The statements provided have capabilities designed to make 
the handling of error log data as simple as possible. 

5.5. 1 The SET Statement 

SET sets the value of a variable to the results of a computation. The format is as follows: 

SET variable_name TO expression ; 

The expression is evaluated using the type of the specified variable, and the variable is set to 
the value of the expression. 

5.5.2 The INCREMENT and DECREMENT Statements 

INCREMENT and DECREMENT adjust the value of numeric variables of length VALUE (a 
word on a PDP-11 processor, a longword on a VAX processor) or less by a value. The value 
defaults to 1. The format of the statements is as follows: 

INCREMENT variable.name [ BY numeric_expres8ion ] ; 
DECREMENT variable.name [ BY numeric_expression ] ; 

The value of the variable is increased by the value of the numeric expression for the INCREMENT 
statement, and decreased by the value of the numeric expression for the DECREMENT statement. 

5.5.3 The WRITE Statement 

WRITE writes information to a specified output location. The format is as follows: 
WRITE (expression [,...]) TO output FORMAT format ; 

The expressions are printed in the order specified. The optional output clause can contain 
either the specifications REPORT or ERROR. ERROR directs output to the invoking terminal. 
REPORT is the default and directs output to the output report. The REPORT file must be 
open. The ERROR file is always open. The format for printing the output report is described 
in Section 5.10. 
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5.5.4 The WRITE-GROUP Statement 

WRITE —GROUP writes a decoded block of data. The data definitions define the formatting. 
The format is as follows: 

WRITE.GROUP group_name TO output FORMAT format, format ; 

The group name is the name of the group of variables or data items to be written. The optional 
output specification is the same as for the WRITE statement and has the same defaults. The 
format for printing the output data is described in Section 5.10. 

The group name can be followed by a sjmibol list, as follows: 

group.name (8ymbol_name [,...]) 

In this case, only the specified symbols are listed. 

The first FORMAT clause is for printing all data items, the second FORMAT clause is for printing 
all BIT and FIELD items. 

5.5.5 The DECODE Statement 

The DECODE statement performs specialized declaration-to-text translation. The statement has 
the following form: 

DECODE variable.name = group name ; 

<data-item> [ <bit-number> ] ; 

<data-item> [ <bit-number> ] ; 

<data-item> t <bit-number> ] ; 
END_DECODE ; 

Each of the data items must be a data item in the specified group. The bit numbers are numbers 
of bits in the data item. The DECODE statement processes the data items in the order specified, 
checking the specified bits. If a bit is found to be set to true, the corresponding bit-to-text 
translation for that bit is performed, and the result returned in the specified variable. This 
completes the statement. A data item can be preceded by a NOT, which indicates the specified 
bit must be set to false for the bit-to-text translation to be performed. If no bit-to-text translation 
is found, the null string is returned. 

5.6 Control Statements 

Control statements direct RPT by defining and invoking procedures and controlling termination 
of the procedure. Other control statements also conditionally control the execution of statements 
in a procedure. These are called conditional statements. 

6.6. 1 The MODULE Statement 

MODULE declares the name of the module being compiled. The format is as follows: 
MODULE name Ident ([attribute [,...]]) ; 
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Parameters 

MODULE 

MODULE must be the first statement in any module. Each module must end with an 
END_MODULE ; statement. 

name 

The module name specifies the name to be used when the module is inserted into the 
control file library. 

ident 

The module ident is a quoted string to be inserted in the module header. 

attribute 

The optional module attributes specify information to be used in processing the module. 
The following two attributes are recognized: 

KEEP 

Specifies that if a module cache is used by RPT, the module should be kept because it is 
likely to be used again. 

FLUSH 

Specifies that if a module cache is used by RPT, the module should be flushed because it 

is unlikely to be used again. 

6.6.2 The LITERAL Statement 

The LITERAL statement assigns a name to a literal value. All LITERAL statements in a module 
must precede any PROCEDURE statement. The format of a LITERAL statement is as follows: 

LITERAL group. name = complletime.constant.expression ; 

The name is equivalent to the value of the compiletime constant expression, and can be used 
in any expression or compiletime constant expression to represent the specified value. 

5.6.3 The CALL Statement 

CALL invokes a subroutine. CALL has the following format: 

CALL [MODULE module_nane_expression] 

PROCEDURE procedure_name_expression 
[COROUTINE procedure_name_expression] ; 

Parameters 

MODULE 

The optional module name expression specifies the module to be called. If the module 
name is not specified, the specified procedure is assumed to be in the current module. 

PROCEDURE 

The procedure name specifies the procedure to call. 
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COROUTINE 

The optional COROUTINE argument specifies that the two called procedures are coroutines. 
The first called procedure is specified as in the normal form of a CALL statement. The 
procedure specified using the COROUTINE argument is executed first. That procedure can 
then execute a statement that passes control to the other procedure specified in the CALL 
statement. None of the declarations is lost. 

The two procedures can trade control back and forth using the COROUTINE statement. 
Each time a COROUTINE statement is executed, the other procedure resumes execution 
from the point of the last COROUTINE statement. If one of the procedures returns, control 
passes to the other procedure as if a COROUTINE statement were executed. When both 
procedures have completed, the coroutines exit to the caller. 

5.6.4 The RETURN Statement 

The RETURN statement forces a retiun from a procedure to the calling procedure. RETURN is 
optional at the end of a procedure. The format of the RETURN statement is as follows: 

RETURN ; 

The RETURN statement terminates the current procedure and returns control to the calling 
procedure. 

5.6.5 The PROCEDURE Statement 

The PROCEDURE statement declares the beginning of a procedure. It has the following format: 
PROCEDURE procedure.name statement_block ; 

Parameters 

procedure name 

The procedure name cannot be more than 15 characters in length. Names can include the 
letters A to Z, the numbers to 9, the dollar sign ($), and the underscore (_). The leading 
character of a name must be alphabetic. 

statement block 

The statement block is executed as the named procedure. 

5.6.6 The IF-THEN-ELSE Statement 

The IF-THEN-ELSE statement is the most basic conditional statement. (Other conditional 
statements are provided to simplify the handling of common situations that would be 
cumbersome with IF-THEN-ELSE.) The IF-THEN-ELSE statement has the following format: 

IF logical.expression THEN block ; 
[ELSE block;] END.IF ; 

If the logical expression is set to true, the block following the THEN statement is executed. If 
the logical expression is set to false, the block following the ELSE statement is executed. The 
ELSE clause is optional. If it is not specified, no action is performed if the expression is set to 
false. 
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Each block consists of a single statement. Using BEGIN-END statements, a block can contain a 
compound statement. See Section 5.6.11 for a description of how to make multiple statements 
appear as a single logical entity to conditional statements by using BEGIN-END statements. 

5.6.7 The CASE Statement 

The CASE statement selects one of a set of possible outcomes based on an expression. The 
format of a CASE statement is as follows: 



CASE expression OF 
[ expression .... ] 
[ expression .... ] 
[ expression .... ] 

[ELSE block ;] 

END.CASE ; 



block ; 
block ; 
block ; 



CASE executes the block corresponding to the first expression equal to the numeric expression. 
If ELSE is specified and no expression matches, it is executed. 

5.6.8 The SELECT Statement 

The SELECT statement is a variation of CASE. SELECT selects one of a given set of blocks. 
The general format is as follows: 

SELECT nuffleric_expres8ion OF 

block ; 

block : 

block ; 
[ELSE block ;] 
END.SELECT; 

SELECT selects the nth block, where n is the value of the numeric expression and is greater 
than or equal to 1. If the last block is preceded by ELSE, the block is executed if and only if 
the value of the numeric expression exceeds the number of blocks supplied. 

5.6.9 The WHILE, UNTIL, and DO Statements 

The WHILE, UNTIL, and DO statements control conditional looping. To specify a conditional 
loop, specify a block of statements to be conditionally executed and an expression to control 
the execution. The following conditions apply to these statements: 

• The DO statement specifies the block of statements to be conditionally executed. 

• The WHILE statement specifies an expression to be considered satisfied if it is set to true. 

• The UNTIL statement specifies an expression to be considered satisfied if it is set to false. 

• A DO statement must be specified with a WHILE or UNTIL statement. The block of 
statements specified by the DO statement is executed until the condition specified by the 
WHILE or UNTIL statement is no longer satisfied. 

• If a DO WHILE or DO UNTIL statement is specified, the DO statement is executed once 
before testing the condition. If a WHILE DO or UNTIL DO statement is specified, the 
condition is tested first before executing the DO statement. 

You can use the WHILE, UNTIL, and DO statements in the following combinations: 

DO block VffllLE expression ; 
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Executes the block once, then evaluates the expression. If the expression is set to true, the 
block is repeated. If the expression is set to false, execution continues following the WHILE 
statement. 

DO block UNTIL expression ; 

Executes the block once, then evaluates the expression. If the expression is set to false, the 
block is repeated. If the expression is set to true, execution continues following the UNTIL 
statement. 

WHILE expression DO block 

Evaluates the expression. If the expression is set to true, the block is executed and the process 
repeated. If the expression is set to false, execution continues following the DO statement. 

UNTIL expression DO block 

Evaluates the expression. If the expression is set to false, the block is executed and the process 
repeated. If the expression is set to true, execution continues following the DO statement. 

6.6.10 The LEAVE Statement 

The LEAVE statement immediately terminates the current DO statement. The control expression 
in the associated UNTIL or WHILE statement is considered satisfied and is not reevaluated. 

5.6. 1 1 The BEGIN-END Statement 

The BEGIN-END statement forces a compound statement to be treated as one statement for 
purposes of conditionals. For example, to process two statements in the THEN clause of an IF 
statement, use the the following construct: 

IF logical expression 
THEN 

BEGIN 

statement 1 ; 
statement 2 ; 
END ; 
ELSE 

statement ; 
END_IF ; 

5.6.12 Lexical Conditionals 

Lexical conditionals perform conditional handling at compilation. A lexical conditional is valid 
wherever a statement is valid. Lexical conditionals have the following format: 

$IF compiletiiiie_con8tant_expre88ion 
$THEN 

statement_block 
[$ELSE 

statenent.block] 
$END_IF 

The $ELSE block is optional. If the compiletime constant expression is set to true, everything in 
the $THEN block is compiled and the $ELSE block is not compiled. If the compiletime constant 
expression is set to false, the $THEN block is not compiled and the $ELSE block, if present, is 
compiled. 
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Lexical conditionals can be nested to any level. 

5.7 Tables 

The table is one of the fundamental units of data organization for RPT. Tables are used to 
structure large amounts of data to be referenced during report generation. 

5.7.1 Table Structure 

Tables are sets of similar records containing fields by which the records can be referenced. 
Tables and the data in them can either be declared statically as part of the definition of a 
given control file module, or they can be declared dynamically during the operation of RPT. 
Static tables hold reference data, v^rhile dynamic tables store information computed during the 
operation of RPT. 

Each record in a table is a sequence of named fields. The definition of the table defines the 
names of the fields and their sequence. 

You refer to tables by name. Table names follow the ordinary rules for naming groups. The 
name cannot be more than 15 characters in length. Names can include the letters A to Z, the 
numbers to 9, the dollar sign ($), and the underscore (_). The leading character of a name 
must be alphabetic. 

Fields in a table are also named. Field names follow the same rules. 

Table entries are manipulated by setting the current entry pointer for a table, and then using 
either the table manipulation statements or simple variable references to read or modify the 
data in the table. 

The following sections describe each of the table-definition and table-manipulation statements 
in detail. 

6.7.2 Ttie TABLE Statement 

The TABLE statement defines a static table. The format of the statement is as follows: 

TABLE table name ; 

naune : type [: print.expressions] ; 

name : type [: print.expresslons] ; 

name : type [: print.expressions] ; 
BEGIN.TABLE 

value , value . [,...] 

value , value , [....] 

value , value , [,...] 
END.TABLE ; 

The declaration list following the TABLE statement specifies each of the fields, their types, and 
print information. The format is the same as for the DECLARE statement. The list values are 
individual compile-time constant expressions separated by commas. Each sequence of list values 
separated by commas (,) and terminated by a semicolon (;) represents one TABLE record. Each 
table value must be of the same type as the corresponding declaration from the declaration list. 
TABLE records cannot be modified at run time. 
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5.7.3 The DYNAMIC-TABLE Statement 

The DYNAKQC-TABLE statement declares a dynamic table. The format of a DYNAMIC-TABLE 
statement is as follows: 



DYNAMIC.TABLE table name 



name 
name 
name 

END.TABLE ; 



type [ 
type [ 
type [ 



print.expressions] 
print.expressions] 
print.expressions] 



Records are placed in the dynamic table at run time through the use of the PUT statement, and 
can be modiiied by some of the POINTER statements. (See Sections 5.7.5 and 5.7.7.) 

5.7.4 The FILE Statement 

The FILE statement is identical to the DYNAMIC—TABLE statement. It is included for 
compatibility only. You should use DYNAMIC— TABLE because the FILE statement may be 
removed in a future release. 

FILE declares a dynamic table. The format of a FILE statement is as follows: 

FILE table name ; 



name 
name 
name 
ENDFXLE 



type [: print.expressions] 
type [: print.expressions] 
type [: print.expressions] 



Records are placed in the file dynamically at run time through use of the PUT statement and 
can be modified by some of the POINTER statements. 

5.7.5 The POINTER Statement 

The POINTER statement adjusts the current pointer for a table. It uses the following sjmtax: 
POINTER table.name action [pointer.variable] ; 
The argument action can be one of the following: 

FIRST 

Sets the current table pointer to the first record of the table. If there is no next record, then 
the current table pointer is set to null (see RESET). 

NEXT 

Sets the current table pointer to the next record of the table. If there is no next record, then 
the current table pointer is set to null (see RESET). 

PREVIOUS 

Sets the current table pointer to the previous record of the table. If you back up past the 
beginning, then the table pointer is set to null (see RESET). 

RESET 

Sets the current table pointer to null; that is, there is no table pointer. 

LOAD pointer variable 

Sets the current table pointer to the value of the pointer variable. 

Control File Language Guide 5-37 



CLEAR 

The specified table must be a dynamic table (see Section 5.7.3). Deletes all records from 
the dynamic table and sets the current table pointer to null (see RESET). 

DELETE 

The specified table must be a dynamic table. Deletes the current record and advances the 
pointer to the next record. If there is no next record, then the current table pointer is set to 
null (see RESET). 

MOVE pointer variable 

The specified table must be a file (see Section 5.7.4). The record pointed to by the pointer 
variable is moved to the current record position, and the current record and all following 
records are moved up one record. This is used mainly for sorting records in a file. 

5.7.6 The FIND Statement 

The FIND statement finds a record in a table using one or more key values. The format of the 
FIND statement is as follows: 

FIND table_na]ne field-value[. . . .]SELECT expression ; 

The table is searched until an entry with all specified fields having the specified value is 
encountered. Tables are searched sequentially from the current pointer position. If no record is 
found, the current pointer for the table is set to null. 

If you specify the optional SELECT clause, a record does not satisfy the search criteria unless 
the select expression, evaluated with the current record for the table set to the specified record, 
is set to true. 

5.7.7 Ttie PUT Statement 

The PUT statement creates a new record in a table. The specified table must be a dynamic table 
(see Section 5.7.3). The PUT statement has the following format: 

PUT table_nane f ield=expre8sion , . . . ; 

Sets the specified fields of the record to the values of the specified expressions. Note that all 
fields must be specified; none of the fields of the record is optional. 

5.8 Lists 

This section describes how CFL handles expression lists. 
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5.8. 1 The LIST Statement 

The LIST statement declares a list of expression groups. The format of the LIST statement is as 
follows: 

LIST list_name ; 

expression [, . ■ ■] 
expression [,...] 
expression [,...] 

END_LIST : 

The expression lists can then be referenced by the SIGNAL, SIGNAL _STOP, and MESSAGE 
statements, which are described in Section 5.9. 

5.8.2 The SEARCH Statement 

SEARCH locates a specific entry in a list. The SEARCH statement has the following format: 

SEARCH list .name expression [,.] 
GET variable [,...] 
FLAG variable ; 

The specified list is searched sequentially until an entry is found where each of the SEARCH 
expressions is equal in value to the corresponding LIST expression in the same expression list. 
The variables in the GET clause are then set to the corresponding remaining expressions of 
the expression list, and the FLAG variable is set to true. If no match is found, the variables 
specified in the GET clause are unchanged, and the FLAG variable is set to false. 

5.9 Signalling 

This section describes the signalling facilities of CFL. 

Signalling breaks the control flow in the report to handle special conditions. Control goes to a 
special routine established by the user called a handler routine. When you signal a condition 
using the signalling statements, the most recently declared handler routine is called. The handler 
routine can then take the appropriate action. 

Any routine can establish a handler routine. When you signal a condition, you can optionally 
suppress the change in the flow of control, and cause the handler to return to the routine 
executing the signal. 

When a condition is signalled, a message describing the event is appended to the file ERROR, if 
the file exists. The message inserted in the ERROR file consists of a sequence of comma-delimited 
quoted strings, corresponding to the arguments to the SIGNAL-class statements. 

5.9. 1 The ENABLE Statement 

The ENABLE statement has the following format: 

ENABLE [MODULE expression] PROCEDURE expression ; 

The procedure becomes the condition handler for this procedure and all called procedures, 
unless a called procedure in turn contains an ENABLE statement. 
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5.9.2 The SIGNAL Statement 

The SIGNAL statement has the following format: 

SIGNAL message.code PARAMETERS expression_list ; 

The message code and expressions in the expression list are ASCII strings. When the SIGNAL 
statement is executed, these expressions are evaluated and the resulting ASCII strings are 
appended to the ERROR file as quoted strings separated by commas. The format is as follows: 

'message code' , ' expressionl ' [, ' express ion2 ' [....]] 

The signal-handling routine is then called. After execution of the signal-handling procedure, 
execution resumes following the statement. 

5.9.3 The SIGNAL-STOP Statement 

The SIGNAL -STOP statement is the same as the SIGNAL statement, except that after execution 
of the signal-handling procedure, execution resumes following the call to the procedure that 
executed the ENABLE statement. The format is as follows: 

SIGNAL.STOP message.code PARAMETERS expression.list ; 

6.9.4 The MESSAGE Statement 

The MESSAGE statement has the same format as the SIGNAL statement. It causes the appended 
string to be placed in the ERROR file, but does not cause any signal processing. The format is 
as follows: 

MESSAGE message.code PARAMETERS expression.list ; 

6.9.5 The CRASH Statement 

The CRASH statement causes an immediate abort of RPT. You use it in cases of error handling 
where the signalling mechanism is inadequate. The CRASH statement has the following format: 

CRASH ; 

CRASH causes a detailed dump of many of RPT's internal data structures. 

5. 1 Print Formatting 

This section describes the output-formatting facilities of CFL. 
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5.10.1 The FORMAT String 

The FORMAT parameter in the WRITE and WRITE -GROUP statements expresses output- 
formatting information. The FORMAT parameter has the following syntax: 

FORMAT f ormat_8tring 

The format string can be any ASCII string. The string is printed after substitution specified by 
output directives. The directives have the following format: 

! [n] [m]dd 

In this format, dd is the 2-character directive, m is the optional argument, and n is the optional 
repeat count. The square brackets need not be included if there is no repeat count. This syntax 
is the same as that for the VMS %FAO facility. A double exclamation point (!!) prints as a 
single exclamation point. 

Multiple format strings can be specified by separating them with the concatenation operator, 
the vertical bar ( I ), which is ASCII 174. They are treated as one concatenated string. 

The allowed directives are described in the following sections. 

5. 1 0. 1 . 1 Control Directives 

The control directives control the processing of the format string. The control directives are as 
follows: 

!nCE Repeat the FORMAT clause. 

!nCF When used with a WRITE statement, this directive terminates output if the values 

of all expressions have been output. When used with a WRITE —GROUP statement, 
this directive terminates output if all fields in the specified group have been output. 
The effect in both cases is to terminate evaluation and output of the format string 
if there are no more values to be output. 

5.10.1.2 Formatting Directives 

The formatting directives output carriage-control information. The formatting directives are as 
follows: 

!nFC Print following output beginning at column n. 

!nFS Space the current output print column forward n columns. 

!nFL Output n-1 blank lines. Printing resumes on the line following the blank lines. 

The default, n=l, causes output to begin on the line following the current line. 

!nFP Output a page break. 
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5.10.1.3 Data-Formatting Directives 

The data-formatting directives control the output of data. The data-formatting directives are as 
follows: 

!nDF Print the field name of the current output field. The argument specifies the field 

width to be used for the name. The name is printed left-justified. 

!nDP Print the current output field. 

The argument specifies the field width to be used for the field. For numeric fields, 
the field width n must be greater than the field width specified when the field was 
defined. If all fields have been printed, output terminates. 

5. 1 1 User-Interface Handling 

The CFL compiler implements two user-interface modes: command mode and option mode. In 
command mode, you specify the input and output files to be processed, using either the MCR 
CFL command or the DCL CREATE/CFL command. In option mode, the compiler prompts 
you for option lines before compilation takes place. 

You do not need to invoke the option mode if you are in the MCR command mode. The 
compiler automatically prompts you for option lines after you have entered your command line. 
In DCL, however, you must explicitly invoke option mode from the command line by using the 
/OPTIONS qualifier. 

5.11.1 Command Mode 
Format 

CFL>output_lHe [ . list_f ile] [ , symbol.f ile] =input_f ile [ . symbol.f ile] 

$ CREATE/CFL [/ [NO] INTERMEDIATE_FQRM] [/LIST] input.f ile [/OPTIONS] [/SYMBOL] 

In the MCR command line, all files to the left of the equal sign (=) are output files, and all files 
to the right of it are input files. 

The MCR arguments and DCL qualifiers to the command mode are as follows: 

output file 
/[NO]INTERMEDIATE_FORM[:iform_file] 

The output file is the compiled intermediate form (IFORM) output file. It has the default 

file type ICF. In MCR syntax, you must specify the output file. 

The DCL CREATE/CFL command assumes that the output file has the same name as the 
input file, unless you use the /INTERMEDIATE—FORM qualifier to specify another name. 
The /NOINTERMEDL\TE_FORM qualifier suppresses the creation of an IFORM (object) 
file. 

listing file 
/LIST[:llst_flle] 

The compiler listing file has the default file name input_file.LST. 

In DCL, you use the /LIST qualifier to generate a compiler listing file. The default is not 
to create a listing file. 
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symbol file 

/SYMBOL[:symbol_(lle] 

The symbol output file is a compilation symbol table. The symbol file must be specified 
as an argument whenever you compile a module that will be called from this module at 
execution time. It has the default file name input_file.SYM. 

The symbol input file is the compilation symbol table from the module that calls the module 
being compiled at execution time. 

In DCL, you use the /SYMBOL qualifier to create an output symbol file. The default is not 
to create a symbol file. 

input (lie 

The input file is the CNF source file. 

/OPTIONS 

In the DCL CREATE/CFL command line, you use the /OPTIONS qualifier to invoke the 
option mode of the CFL compiler. If you do not specify the /OPTIONS qualifier, the 
compiler does not implement the option mode, but proceeds to execute your command line. 

In the MCR command line, there is no /OPTIONS qualifier. The compiler invokes the 
option mode before it executes your command line. 

5.11.2 Option Mode 

Option mode uses MCR only. When you enter the MCR CFL command line or the DCL 
command line with the /OPTIONS qualifier, the compUer requests options with the following 
option-mode prompt: 

Option> 

Press the RETURN key after each option you enter, and the Option> prompt reappears. Options 
are terminated when a line beginning with a slash ( / ) is entered, at which point the compilation 
takes place. See Section 4.2.3 for an example of CFL option-mode declarations. 

In option mode, the compiler accepts the LITERAL option in the following format: 

Option>LITERAL group. name = value 

This is the same syntax as for the LITERAL statement in the source file. The LITERAL option 
is declared for the duration of the compilation. The only valid values are the following items: 

• Quoted strings 

• Numeric values 

• Logical true values 

• False values 

Numeric values must be positive decimal values that are treated as machine values. 
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5.12 ERLCFL Report Messages 

ERLCFL-F-ASCIIBIG, ASCII literal quoted string too long for type. 

Explanation: An ASCII radix numeric literal in a control file source module contains too 
many characters for the specified numeric type. 

User Action: Correct the user-written module or submit a Software Performance Report 
(SPR) for DIGITAL-supplied modules. 

ERLCFL-F-BADDIGIT, Invalid numeric digit in conversion. 

Explanation: A numeric literal or the ASCII string argument for the %COD$OCTAL, 
%COD$DECIMAL, %COD$HEX, %COD$BCD, %COD$BINARY, or %COD$MACHINE 
function contains an invalid character for the specified radix or was nuU or blank. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-BITFLDSIZ, Bit or field too large in extraction operation. 

Explanation: The bit or field in an extraction operation exceeds the size of the value on 
which the extraction is performed. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-BITNOPREC, A BIT or FIELD must have a preceding data item. 

Explanation: A BIT or FIELD declaration in a control file source module must be preceded 
by a data item within the declaration. 

User Action: Correct the user- written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-BITNOTVAR, A BIT or FIELD not allowed on variable-lengtti data item. 

Explanation: A BIT or FIELD declaration in a control file source module is not allowed on a 
variable-length data item. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-BITNUMINV, BIT number outside the declared data item. 

Explanation: The bit number in a BIT declaration for a data item is too large for the data 
item. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-BITTOOHIG, Bit number too large for specified storage unit. 

Explanation: The bit number specified by the character string portion of a #BI, #WI, #LI, 
#QI, or #VI numeric literal is too large for the specified value size. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 
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ERLCFL-F-BYTERAD60, A BYTE data item cannot print in Radix-50 format. 

Explanation: The print radix for a BYTE declaration cannot be Radix-50. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-CASENOTDAT, A declaration clause must be in a data declaration. 

Explanation: A declaration CASE clause attempted to declare data but was not contained 
within a declaration. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-CFLINPUT, Could not open input source file. 

Explanation: CFL could not open the input source file specified on the command line. 

User Action: Check the file specification, and make sure that you have access to the specified 
file. 

ERLCFL-F-CFLISTiNG, Could not create listing output file. 

Explanation: CFL could not create the listing output file specified on the command line. 

User Action: Check the file specification, and make sure that you have access to the specified 
file. 

ERLCFL-F-CFLMODULE, Could not create module output file. 

Explanation: CFL could not create the module output file specified on the command line. 

User Action: Check the file specification, and make sure that you have access to the specified 
file. 

ERLCFL-F-CFLSYMBOL. Could not open symbol file for input. 

Explanation: CFL could not open the input symbol file specified on the command line. 

User Action: Check the file specification, and make sure that you have access to the specified 
file. 

ERLCFL-F-CFLSYMOUT, Could not create symbol output file. 

Explanation: CFL could not create the output symbol file specified on the command line. 

User Action: Check the file specification, and make sure that you have access to the specified 
file. 

ERLCFL-F-CIVIDOPTERR, Option line syntax error. 

Explanation: CFL encountered a syntax error on the option line input. 

User Action: Correct the error and run CFL again, or submit an SPR for DIGITAL-supplied 
command files. 
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ERLCFL-F-CMDSPCERR, Command line syntax error. 

Explanation: CFL encountered a syntax error on the command line input. 

User Action: Conect the error and run CFL again, or submit an SPR for DIGITAL-supphed 
command files. 

ERLCFL-F-DECTOOBIG, Declaration too iarge, too many symbols. 

Explanation: A declaration in a control file is too large to be compiled. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-DIVZERO, Attempt to divide by zero. 

Explanation: A control file module contains a division by zero in a compile-time constant 
expression. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-EXPTOOBIG, Operator stack overflow. Expression too complex. 

Explanation: An expression in a control file source module is too complex to be compiled. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-EXPTOOLAR, Operator stack overflow. Expression too complex. 

Explanation: An expression in a control file source module is too complex to be compiled. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-FIELDBIG, FIELD exceeds size of the declared data Item. 

Explanation: A FIELD declaration in a control file source module exceeds the bounds of its 
corresponding data item. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-FIELDBITI, FIELD starting bit is outside ttie declared data item. 

Explanation: A FIELD declaration in a control file source module exceeds the bounds of its 
corresponding data item. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-FIELDSMAL, FIELD width must be at least one bit. 

Explanation: A FIELD declaration in a control file source module did not have a width 
specified. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 
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ERLCFL-F-FILERCLOS. File Close error. 

Explanation: An error occurred wher\ CFL attempted to close a file. 

User Action: Check for file access conflicts, device errors, or low pool condition, 
ERLCFL-F-FILERREAD, File read error. 

Explanation: An error occurred when CFL attempted to read a file. 

User Action: Check for file access conflicts, device errors, or low pool condition. 
ERLCFL-F-FILERWRIT, File write error. 

Explanation: An error occurred when CFL attempted to write to a file. 

User Action: Check for file access conflicts, device errors, or low pool condition. 

ERLCFL-F-FiLINTOPN, Internal error - File already open. 

Explanation: This is an internal error within CFL. 

User Action: Please submit an SPR with any information you have. 
ERLCFL-F-FILINVCOD, Internal error - Invalid file code for specified operation. 

Explanation: This is an internal error within CFL. 

User Action: Please submit an SPR with any information you have. 
ERLCFL-F-FLUSHINV, FLUSH attribute not allowed with KEEP attribute. 

Explanation: A control file source module specified both the FLUSH and KEEP module 
attributes. 

User Action: Correct the user-written module or submit an SPR for DlGITAL-supplied 
modules. 

ERLCFL-F-FUNFIELDS, Invalid conversion code argument to time conversion function. 

Explanation: A control file source module contains a time conversion function with an invalid 
value for the conversion code argument. 

User Action: Correct the user-written module or submit an SPR for DlGITAL-supplied 
modules. 

ERLCFL-F-FUNINVPOi, Invalid string pointer value In string function. 

Explanation: A control file source module contains a %STR$PARSE or %STR$QUOTE 
function where the value of the pointer argument is larger than the length of the string 
argument. 

User Action: Correct the user-written module or submit an SPR for DlGITAL-supplied 
modules. 
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ERLCFL-F-FUNNOTCHA, Argument to STR$CHAR is not in valid range for ctiaracter. 

Explanation: The value of the argument for the %STR$CHAR function must be in the range 
to 127io. 

User Action: Correct the user-written module or submit an SPR for DlGITAL-supplied 
modules. 

ERLCFL-F-FUNNOTCOIVI, Function call not allowed in compile-tlme constant expression. 

Explanation: A control file source module contains a function call that could not be evaluated 
at compile time, where a compile-time constant expression was required. 

User Action: Correct the user-written module or submit an SPR for DlGITAL-supplied 
modules. 

ERLCFL-F-FUNQUOODD, Quote string in STRSQUOTE function must tiave even length. 

Explanation: A control file source module contains a %STR$QUOTE function, where the 
quote string argument is not an even length. 

User Action: Correct the user-written module or submit an SPR for DlGITAL-supplied 
modules. 

ERLCFL-F-FUNSTRSIZ, Output string from string function too large. 

Explanation: A control file source module executed a string function that resulted in a string 
longer than 255 characters. 

User Action: Correct the user-written module or submit an SPR for DlGITAL-supplied 
modules. 

ERLCFL-F-FUNWRONGA, Incorrect number of arguments in function call. 

Explanation: A control file source module contains a function call with the wrong number 
of arguments. 

User Action: Correct the user-written module or submit an SPR for DlGITAL-supplied 
modules. 

ERLCFL-F-FUNWRONGC, Incorrect number of arguments in function call. 

Explanation: A control file source module contains a function call with the wrong number 
of arguments. 

User Action: Correct the user-written module or submit an SPR for DlGITAL-supplied 
modules. 

ERLCFL-F-HEAPOVERF, Heap too small to hold value. Overflow. 

Explanation: The heap used for processing values and expressions has overflowed. 

User Action: Edit CFLBLD.CMD to increase the extension for program section VHEAPO, and 
rebuild CFL. 
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ERLCFL-F-IFNOTDATA, A declaration IF clause must be In a data declaration. 

Explanation: An IF clause cannot be used to declare data outside of a declaration in a control 
file source module. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-ILLCHAR, Illegal character In input. 

Explanation: An invalid character was found in a control file source module. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-INTEOTMAN, Internal - More than one operator on stack at term end. 
Explanation: This is an internal error within CFL. 
User Action: Please submit an SPR with any information you have. 

ERLCFL-F-INTEOTNUL, Internal - End of term reached with null operator stack. 
Explanation: This is an internal error within CFL. 
User Action: Please submit an SPR with any information you have. 

ERLCFL-F-INTEXPNOO, Infernal - Operator missing from operator stack. 
Explanation: This is an internal error within CFL. 
User Action: Please submit an SPR with any information you have. 

ERLCFL-F-INTFUNEND, Internal - Stack entry missing at function termination. 

Explanation: This is an internal error within CFL. 

User Action: Please submit an SPR with any information you have. 

ERLCFL-F-INTFUNMIS, internal - Function code missing from operator stock. 

Explanation: This is an internal error within CFL. 

User Action: Please submit an SPR with any infom\ation you have. 

ERLCFL-F-INTFUNNOT, Internal - Function code missing at function termination. 
Explanation: This is an internal error within CFL. 
User Action: Please submit an SPR with any information you have. 

ERLCFL-F-INTOPRNOT, internal - Operator outside of an expression term. 
Explanation: This is an internal error within CFL. 
User Action: Please submit an SPR with any information you have. 
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ERLCFL-F-INTPROUND, Internal - Compiler internal production stack underflow. 
Explanation: This is an internal error within CFL. 
User Action: Please submit an SPR with any information you have. 

ERLCFL-F-INTSYMLNK, Internal error - Invalid symbol linkage setup in module. 
Explanation: This is an internal error within CFL. 
User Action: Please submit an SPR wdth any information you have. 

ERLCFL-F-INTWRONGP, Internal - Wrong production popped internal production. 
Explanation: This is an internal error within CFL. 
User Action: Please submit an SPR writh any information you have. 

ERLCFL-F-INVFUNCT, Invalid function name specified. 

Explanation: A control file source module specified an invalid function name. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-INVNUMSIZ, Internal - A numeric variable has an invalid size. 
Explanation: This is an internal error within CFL. 
User Action: Please submit an SPR with any information you have. 

ERLCFL-F-INVPOIACT, Invalid POiNTER-statement action name. 

Explanation: A control file source module specified an invalid action for a POINTER 
statement. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-iNVRADCNV, internal error - invalid radix code for conversion. 
Explanation: This is an internal error within CFL. 
User Action: Please submit an SPR with any information you have. 

ERLCFL-F-KEEPINV, KEEP attribute not allowed with FLUSH attribute. 

Explanation: A control file source module specified both the FLUSH and KEEP module 
attributes. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-LITINVTYP, Internal error - Literal in literal table tias invalid type. 
Explanation: This is an internal error within CFL. 
User Action: Please submit an SPR with any information you have. 
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ERLCFL-F-LITNOVALU, Internal error - No value to load into literal value. 
Explanation: This is an internal error within CFL. 
User Action: Please submit an SPR with any information you have. 

ERLCFL-F-MODATTRIN, Invalid module attribute name specifled. 

Explanation: A control file source module specified an invalid module attribute. 

User Action: Correct the user-written module or submit an SPR for DlGITAL-supplied 
modules. 

ERLCFL-F-MODZERO, Attempt to modulus by zero. 

Explanation: A control file source module contains a modulus by zero in a compile-time 
constant expression. 

User Action: Correct the user-written module or submit an SPR for DlGITAL-supplied 
modules. 

ERLCFL-F-NOQUOTE, String literal missing closing quote. 

Explanation: A string literal in a control file source module was not terminated by a closing 
apostrophe. 

User Action: Correct the user-written module or submit an SPR for DlGITAL-supplied 
modules. 

ERLCFL-F-NULLOPERA, Internal - Null suffix operand on non-suffix operator. 
Explanation: This is an internal error within CFL. 
User Action: Please submit an SPR with any information you have. 

ERLCFL-F-NUMFILLCH, A print fill Character string must contain one character. 

Explanation: A print fill character in a declaration in a control file source module must 
contain one character. 

User Action: Correct the user-written module or submit an SPR for DlGITAL-supplied 
modules. 

ERLCFL-F-NUMINVOPR, Invalid numeric double-operand operation code. 
Explanation: This is an internal error within CFL. 
User Action: Please submit an SPR with any information you have. 

ERLCFL-F-OPRFLSCOM, Internal error - Attempt to fiusti a CTCE operand. 

Explanation: This is an internal error within CFL. 

User Action: Please submit an SPR with any information you have. 
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ERLCFL-F-OPRINVLOG, Attempt to perform logical operation on an Invalid type. 

Explanation: A control file source module attempted to perform a logical operation with 
operands that were neither numeric nor logical. 

User Action: Conect the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-OPRNOTCOM, Operator In CTCE cannot be evaluated at complle-tlme. 

Explanation: A compile-time constant expression in a control file source module contains an 
operator that could not be evaluated at compile time. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-OPRNOTIMP, Operation not implemented. 

Explanation: A control file source module attempted to perform a multiplication where both 
operands were larger than a word value. 

User Action: Correct the user-vratten module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-PARSEREOF, Premature EOF encountered. 

Explanation: The end-of-fiile was reached on a control file source module before the end of 
the module was reached. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-PROSTKOVR, Compiler internal production stack overflow. 
Explanation: This is an internal error within CFL. 
User Action: Please submit an SPR with any information you have. 

ERLCFL-F-PRSSTKOVR, Parse stacit overflow. 

Explanation: This is an internal error within CFL. 

User Action: Please submit an SPR with any information you have. 

ERLCFL-F-RAD50BYTE, Cannot convert a byte using Radlx-50 conversion. 

Explanation: A control file source module attempted to convert an ASCII string or numeric 
literal to a BYTE using Radix-50 conversion. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-RADINVCOD, Invalid radix code string in radix literal. 

Explanation: A control file source module contains an invalid radix code in a numeric literal. 

User Action: Conect the user-written module or submit an SPR for DIGITAL-supplied 
modules. 
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ERLCFL-F-RADINVRAD, Invalid radix ciiaracter specified in radix literal. 

Explanation: A control file source module contains an invalid radix code in a numeric literal. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-RADLITINV, Invalid literal type ctiaracter In radix literal. 

Explanation: A control file source module contains an invalid type character in the radix 
portion of a numeric literal. 

User Action: Correct the user-v^fritten module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-RELINVCOD, invalid relational operator. 
Explanation: This is an internal error within CFL. 
User Action: Please submit an SPR with any information you have. 

ERLCFL-F-RESBITILL, A BIT or FIELD data Item cannot be declared RESERVED. 

Explanation: A control file source module contains a BIT or FIELD declaration for a 
RESERVED data item. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-RESINVPRT, Print expression list not allowed on RESERVED data. 

Explanation: A control file source module contains a print expression for a RESERVED data 
item. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 

modules. 

ERLCFL-F-SPCNOTVAR, Special variable cannot be used in a CTCE. 

Explanation: A control file source module used one of the predeclared special variables in a 
compile-time constant expression. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-SRCDATERR, Failed to get creation date of source file. 

Explanation: An error occurred when CFL tried to get the creation date of the control file 
source module. 

User Action: Check for file access conflicts, device errors, or low pool condition. 
ERLCFL-F-SUBEXTBIG, Substring extraction end element exceeds string. 

Explanation: A control file source module attempted to perform a substring extraction in 
which the substring exceeded the end of the string. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 
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ERLCFL-F-SYMNOTCOM, A variable Is not valid In a complle-tlme constant expression. 

Explanation: A control file source module contains a variable in a compile-time constant 
expression. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-SYMNOTLIT, Speclfled LITERAL symbol name not part of LITERAL group. 

Explanation: A control file source module contains a reference to a LITERAL symbol that 
has not been defined for the specified LITERAL group. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-SYNTAXERR, Syntax error. 

Explanation: CFL encountered a syntax error while compiling the control file source module. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-TABLEBIG, TABLE element has too many literal values. 

Explanation: A control file source module contains a TABLE element with too many values 
for the corresponding TABLE. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-TABLESMAL, TABLE element tias too few literal values. 

Explanation: A control file source module contains a TABLE element with too few values 
for the corresponding TABLE. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-VALSTKOVR, Value stack overflow. 

Explanation: The stack used for processing values and expressions has overflowed. 

User Action: Edit CFLBLD.CMD to increase the extension for program section VLSTKO, and 
rebuild CFL. 

ERLCFL-F-VALUESIZE, Value in expression Is too large. 

Explanation: A control file source module contains a compile-time constant expression in 
which an intermediate value or the final value is too large. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 
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ERLCFL-F-VALUETYPE, Value in expression is wrong type. 

Explanation: A control file source module contains a compile-time constant expression in 
which an intermediate value or the final value is of the wrong type. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-VARLITGRP, A variable name cannot liave thie same group name as a LITERAL. 

Explanation: A control file source module contains a declaration with the same group name 
as a LITERAL declaration. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 

ERLCFL-F-WRITEDES. WRiTE-cIass statement tias invalid destination. 

Explanation: A control file source module contains an invalid destination for the TO clause 
of a WRITE or WRITE -GROUP statement. 

User Action: Correct the user-written module or submit an SPR for DIGITAL-supplied 
modules. 
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Appendix A 



Tuning tiie Error Logging Universal Library 

When the Report Generator task (RPT) starts operation, it scans ERRLOG.ULB and generates 
descriptors in its work space for all the modules it finds in the library. RPT searches these 
descriptors for the appropriate modules when it generates reports. Therefore, if you remove 
modules for devices that your system does not have, RPT operation is faster and does not 
require as much memory or disk space. 

An indirect command file, TUNE.CMD, is included with your error logging system. The 
command file is in the universal library LB:[1,6]ERRL0GETC.ULB. This command file allows 
you to remove unneeded modules from ERRLOG.ULB. 

A. 1 Using the TUNE Command File 

To use TUNE.CMD, you must first extract it from the library by using the following LBR 
command: 

ABR TUNE . CMD=LB : [ 1 , 6] EKRLOGETC . ULB/EX : TUNE 

The file TUNE.CMD is copied to your current directory. You can execute it using the following 
command: 

OTUNE 

The TUNE.CMD file prompts you for a processor type and for a list of the devices you want to 
use with error logging. It then removes the devices you do not select from ERRLOG.ULB and 
writes a new ERRLOG.ULB to the current directory. 

TUNE.CMD requires the actual physical names of the devices you select (RLOl and RL02, for 
example). Since some modules in ERRLOG.ULB handle more than one physical device type, 
the timing conunand includes the module only once. If you select a device name more than 
once, the system displays the following message on your terminal: 

Module <module name> replaced. 

The message is for your information only. The command file then continues to include the 
other modules you specified. 

Example A-1 is an example of using TUNE.CMD. 
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This file creates a library for a PDP-11/ 84 processor with the following devices: 

RP06 

RP05 

RM03 

RM05 

RM80 

RS04 

RK05 

RK06 

RK07 

TU56 

RX02 

TU58 
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Example A-1: Sample Execution of TUNE.CMD 



$CTUNE [RET] 

This conatand procedure is used to tune the error log control file for 
your system configuration. The procedure prompts for the location of 
the master control file (the shipped file) , the CPU type, and the 
error logging devices available on your system. It then creates a new 
version of the control file that contains only the required support. 
The original control file is left unchanged. 

All files are created in your default directory on the default 
device. When cleaning up, all files with the extension of .ICF as 
well as TEMPTUNEO.TMP;* and TEMPTUNEl . TMP ; * are deleted. 

* Continue? [Y/N] : Y [Ml 

* Location of master file [D: LB: [1.6]ERRL0G.ULB] [S] : . [US 

Now enter the CPU type. Hit the escape key for a list of legal 
CPU types. 



* Enter CPU type [S] : IMJ 

The acceptable CPU types are: 
11/23, 11/24, 11/44 
11/70, 11/74 
11/83, 11/84, 11/53. 11/73 



* Enter CPU type [S] : 11/70 \M. 



; Now enter the devices in your configuration separated hy commas. 

; Terminate by entering a period. Hit the escape key for a list of 
; acceptable device names . 

* Enter device naffle(s) [S] : I ESC I 

Below is a list of acceptable device names. If you have more than 
one type of device listed as "x or y or z" you need enter only one. 
For example, if you have RP04s and RP06s you need only enter RP04 
or RP06 - not both. 

The acceptable device names are: 



TU56 
TU58 
TU60 


(DECtape) 
(DECtape II) 
(Cassette) 


RP04 


or RP05 or RP06 


RP07 




RSll 




RK03 


or RK05 


RLOl 


or RL02 


RK06 


or RK07 


RP02 


or RP03 


RM02 


or RM03 



RM05 



(Continued on next page) 
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Example A-1 (Cont.): Sample Execution of TUNE.CMD 



RM80 

RS03 or 

RA60 

RA80 or 

RC25 

RD51 or 

RXOl 

RX02 

MLll 

TE16 or 

TU77 

TEIO or 

TU78 

TSll 

TU80 

TSV05 

TK50 or 



RS04 
RA81 
RD52 or RD53 or RD54 or RD31 or RD32 or RX50 or RX33 

TU16 or TU45 
TUlO or TS03 



TU8i 



* Enter device name(s) 

* Enter device naiiie(s) 

* Enter device name(s) 



[S] 
[S] 
[S] 



RP06,RP05,RM03,RM05,RM80 [M] 
RS04,RK06,RK06,RK07,TU56.RX02.TU58 [RETI 



Extract the files from the master library. 



Build the new library. Note that you may see messages like "Module 
"XYZZY" replaced" if you have selected more than one device having 
the same mnemonic. For example, selecting RK06 and RK07 support will 
produce this message. This type of message can be ignored. 



LBR QTEMPTUNEl, 
Module "ERP456' 
Module "ERP456' 
Module "ERP456' 
Module "ERM23" 
Module "NRM23" 
Module "ERM05" 
Module "ERM80" 
Module "ERK67" 
Module "NRK67" 



TMP 
replaced 
replaced 
replaced 
replaced 
replaced 
replaced 
replaced 
replaced 
replaced 



; Now clean up. 

LBR TEMPLIB.ULB/CO=TEMLIB.ULB 

PIP TEMPLIB.ULB/PU 

PIP TEMPLIB.ULB/TR 

PIP ERRLOG . ULB/RE/NV=TEMPLIB . ULB 

PIP * . ICF ; * , TEMPTUNEO . TMP ; * , TEMPTUNEl . TMP ; */DE 

Finished . 



Now you can copy the new library to LB:[1,6], where it will become the default library for 
RPT. You should maintain the original DIGITAL-supplied ERRLOG.ULB, either on LB:[1,6] or 
in another location. You can then use TUNE.CMD again later on the original ULB file to add 
support for devices that you have taken out. 



A-4 Tuning the Error Logging Universal Library 



A.2 DIGITAL-Supplied Error Logging Modules 

To list the modules in the DIGITAL-supplied universal library, use the following LBR command: 

>LBR ERRLGG.ULB/LI HH] 

Table A-1 lists the modules in this library. 

Table A-1: Modules in ERRLOG.ULB 

Module Name Module Description 

DEVSMl Defines tables for device modules 

DEVUDA MSCP-related module 

DISPATCH Entry module for error log control file 

DMPALL Processes errors from unknown events 

DSPIPI Processes Error Logger command packets 

DSP2P1 Processes device error packets 

DSP3P1 Processes device information packets 

DSP4P1 Processes device control information 

DSP5P1 Processes CPU memory-detected errors 

DSP6P1 Processes system control information 

DSP7P1 Processes control information packets 

DSP8P1 Processes CPU-detected error packets 
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Table A-1 (Cont.): Modules In ERRLOG.ULB 



Module Name Module Description 



EMLll 

ERK05 

ERK67 

ERL12 

ERM05 

ERM23 

ERM80 

ERP07 

ERP23 

ERP456 

ERSll 

ERS34 

ERXOl 

ERX02 

ETAll 

ETCH 

ETSll 

ETU58 

ETU77 

ET0310 

ET1645 

ETSV05 

ETK50 

ETU81 

ETK70 

ERRORM 

EUNKWN 

EllXX ^ 
E1144 
E117X 
E118X 

FINLPl 

FMTNPl 

FMTWPl 

INITMl 

r MSCPCE 
MSCPAT 
MSCP80 
MSCP60 
MSCPEN 
MSCPTO 
MSCPSD 

L MSCP5X 



Control file device modules 



Processes control file error conditions 
Processes errors from unknown devices 

Process CPU/memory packets 

Cleans up control file after processing 
Prints NARROW reports 
Prints WIDE reports 
Initializes control file modules 



MSCP device modules 



A-6 Tuning the Error Logging Universal Library 



Table A-1 (Cont.): Modules in ERRLOG.ULB 



Module Name Module Description 



f NMLll 
NRK67 
NRM05 
NRM23 
NT0310 
NTS 11 

PARSEM 
PARSIM 
PARS2M 
PARS3M 
PRS2AM 
PRS2BM 

SELTMl 

SMRYEP 

SMRYGP 

SMRYHP 

TMSCPE 



Generate notes from device modules 



RPT command line parser 



Selects packets to process 
Prints ERROR summary report 
Prints GEOMETRY summary report 
Prints HISTORY summary report 
TMSCP device module 
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Appendix B 



Drive Serial Numbers 



RPT reports drive serial numbers for those devices that have serial numbers. Table B-1 lists 
the drives that provide serial numbers and the significant digits RPT uses from those serial 
numbers. The number of digits varies by drive type. The digits appear in binary coded decimal 
(BCD) format. 

RPT obtains the serial number from the device electronics. The number is selected through a 
series of jumpers within the device that are set at manufacturing time. These jumpers match 
the low-order digits of the actual device serial number. If any of these jumpers is altered, the 
drive will have a different serial number unless the new jumpers are set to reflect the actual 
device serial number. Therefore, the number RPT prints may not be the same as the number 
on the device identification plate. 

Table B-1: Significant Digits in Drive Serial Numbers 



Device/Controller 


Significant Digits in Serial Number 


RK06 


12 bits, 3 BCD digits 


RK07 


12 bits, 3 BCD digits 


RM80 


16 bits, 4 BCD digits 


TU77 


16 bits, 4 BCD digits 


TU78 


16 bits, 4 BCD digits 


RP04 


16 bits, 4 BCD digits 


RP05 


16 bits, 4 BCD digits 


RP06 


16 bits, 4 BCD digits 


RP07 


16 bits, 4 BCD digits 


RXOl 


N/A 


RX02 


N/A 



Drive Serial Numbers B~l 



Table B-1 (Cont.): Significant Digits In Drive Serial Numbers 
Device/Controller Significant Digits in Serial Number 



RM02 


16 bits, 4 BCD digits 


RM03 


16 bits, 4 BCD digits 


RM05 


16 bits, 4 BCD digits 


TAll 


N/A 


RSll 


N/A 


RP02 


N/A 


RP03 


N/A 


MLll 


16 bits, 4 BCD digits 


TE16/RH11/RH70 


16 bits, 4 BCD digits 


TU16/RH11/RH70 


16 bits, 4 BCD digits 


TU45 


16 bits, 4 BCD digits 


TS03 


N/A 


TElO/TMBll 


N/A 


TUlO/TMBll 


N/A 


RS03 


N/A 


RS04 


N/A 


TSll 


N/A 


TCll 


N/A 


RLOl 


N/A 


RL02 


N/A 


TSV05 


N/A 


RA60/RA80/RA8 1 /RA82 


6 digits 


RC25/RD31/RD32/RX50/RX33 


6 digits 


RD5 1 /RD52/RD53/RD54 


6 digits 


TU80 


N/A 


TU81E 


N/A 


TK50/TK70 


N/A 



B-2 Dn'oe Serial Numbers 



Appendix C 



Error Log Packet Format 



Example C-1 shows the format of an error log packet in memory, as described in the system 
macro EPKDF.MAC. 

When a device error is logged, the error log packet contains device-supplied information to 
describe the error. This information usually consists of the device registers and some additional 
information supplied by the system. 

Error logging also writes context information into the error log packet. This information 
includes the time and date of the error, information about the system that logged the error, and 
information about the I/O operation that generated the error. 

The error logging system also creates packets for events in the system that are not errors, but 
are important to the interpretation of errors (for example, the time error logging starts or stops). 



Error Log Packet Format C-1 



Example C-1: Error Log Packet Format 



THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED 
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER 
COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY 
OTHER PERSON. NO TITLE TO AND OWNERSHIP- OF THE SOFTWARE IS HEREBY 
TRANSFERRED. 

THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE 
AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT 
CORPORATION. 



DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY 
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL. 

IDENT /V02.00/ 
PreriouBly modified by: 
C. Putnam 



OF ITS 



Modified By: 

C. Putnam 



S. Adams 



J. MELVIN 
JJMIOO 

6. Marigowda 
G. Marigowda 

G. Marigowda 



- 27-MAY-83 1.04 

- CPU Detected Errors become code 8 

- MEMORY Detected Errors only are code 5 

- lO-SEPT-83 1.05 

- ADD BIT TO INDICATE LIMIT REACHED 

- 06-NOV-84 V02.00 

- DEFINE ERROR LOG FEATURE MASK DEFINITIONS 

- 17-APR-85 2.01 

- Change E$ORTY to two bytes Instead of one word 

- 25-APR-85 2.02 

- Add new flag bits in E$0FL6 and E$AFLG to indicate 

- internal I/O operation. 

- 17-MAY-85 2.03 

Change Current packet format from 1 to 2. 



.MACRO EPKDFI.L.B 

f 

Error Message Block Definitions 

.ASECT 
Header Subpacket 



(Continued on next page) 



C-2 Error Log Packet Format 



Example C-1 (Cont.): Error Log Packet Format 





+ 

1 Subpacket Length 


in Bytes 


— + 

1 


1 Subpacket Flags 




1 


1 Format Identification 1 Operating System Code 1 


1 Operating System 
i 


Identification 


1 
1 


1 Flags 


1 Context Code 


1 


1 Entry Sequence 




1 


1 Error Sequence 




1 




1 


1 Time Stamp 

1 
1 




1 
1 
1 




1 Reserved 


1 Processor Type 


1 




1 


.=0 
E$HLGH: 


'L' .BLKW 1 


Subpacket Length in Bytes 




E$HSBF: 


'L' .BLKW 1 


Subpacket Flags 




E$HSYS: 


'L' .BLKB 1 


Operating System Code 




E$HIDN: 


'L' .BLKB 1 


Format Identification 




E$HSID: 


•L' .BLKB 4 


Operating System Identification 


E$HCTX: 


'L' .BLKB 1 


Context Code 




£$HFLG: 


'L' .BLKB 1 


Flags 




E$HENS: 


•L' .BUW 1 


Entry Sequence Number 




ESHERS: 


'L' .BLKW 1 


Error Sequence Number 




E$HENC: 


•L- 


Entry Code 




E$HTYC: 


•L' .BLKB 1 


Entry Type Code 




E$HTYS: 


'L' .BLKB 1 


Entry Type Subcode 




EIHTIM: 


•L' .BLKB 6 


Time Stamp 




E$HPTY: 


■L' .BLKB 1 


Processor Type 






.BLKB 1 


Reserved 




E$HURM: 


'L' .BLKW 1 
.EVEN 


Processor Identification 


(URM) 


EIHLEN: 


'L' 


Length 





(Continued on next page) 
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Example C-1 (Cont.): Error Log Packet Format 



Subpacket Flags for E$HSBF 



SM.ERR 


= 'B' 


1 


SM.HDR 


= >B' 


1 


SM.TSK 


= 'B' 


2 


SM.DID 


= >B' 


4 


SM.DOP 


= 'B' 


10 


SM.DAC 


= 'B' 


20 


SM.DAT 


= 'B' 


40 


SM.MBC 


= 'B' 


20000 


SM.CMD 


= "B' 


40000 


SM.ZER 


= "B' 


100000 



Error Packet 

Header Subpacket 

Task Subpacket 

Device Identification Subpacket 

Device Operation Subpacket 

Device Activity Subpacket 

Data Subpacket 

22-bit MASSBUS controller present 

Error Log Command Packet 

Zero I/O Counts 



Codes for field E$HIDN 



ES.INI 


= 'B' 


1 


ES.DAT 


= 'B' 


2 


ES.LIM 


= 'B' 


4 


ES.LOG 


= 'B' 


10 



EH$FOR ='B' 1 ; Current packet format 

Flags for the error log flags byte ($ERFLA) in the Exec. 

Error log Initialized 

Error log receiving data packets 

Error limiting enabled 

Error logging enabled 

Type and Subtype Codes for fields E$HTYC and E$HTYS 

Symbols with names E$Cxxx are type codes for field E$HTYC, 
Symbols with names E$Sxxx are subtype codes for field E$HTYS. 

Error Log Control 

Error Log Status Change 

Switch Logging Files 

Append File 

Declare Backup File 

Show 

Change Limits 

Device Errors 

Device Hard Error 

Device Soft Error 

Device Interrupt Timeout (HARD) 

Device Unsolicited Interrupt 

Device Interrupt Timeout (SOFT) 

Device Information 

Device Information Message 

Device Control Information 
Device Mount 
Device Dismount 
Device Count Reset 
Block Replacement 

Memory Detected Errors 
Memory Error 

System Control Information 
Power Recovery 

Control Information 
Time Change 
System Crash 



ESCCMD 


= ■8' 


1 


E$SSTA 


= 'B' 


1 


E$SSWI 


= 'B' 


2 


ESSAPP 


= 'B' 


3 


EISBAC 


= 'B' 


4 


ESSSHO 


= >B' 


5 


E$SCHL 


= 'B' 


6 


E$CERR 


= 'B' 


2 


E$SDVH 


= >B' 


1 


E$SDVS 


= 'B' 


2 


E$STMO 


= 'B' 


3 


E$SUNS 


= 'B' 


4 


E$STMS 


= 'B' 


5 


ESCDVI 


= >B" 


3 


E$SDVI 


= 'B" 


1 


ESCDCI 


= >B' 


4 


E$SMOU 


= 'B' 


1 


E$SDMO 


= 'B' 


2 


E$SR£S 


= 'B' 


3 


E$SRCT 


= -B' 


4 


E$CMEM 


= 'B' 


5 


E$SMEM 


= 'B' 


i 


E$CSYS 


= >B' 


6 


E$SPWR 


= 'B' 


1 


E$CCTL 


= ■8' 


7 


EISTIM 


= 'B' 


1 


E$SCRS 


= 'B' 


2 



(Continued on next page) 



C-4 Error Log Packet Format 



Example C-1 (Cont.): Error Log Packet Format 



E$SLOA 
E$SUNL 
E$SHRC 



EICCPU 
E$SINT 
E$SINT 



= 'B' 
= 'B' 
= >B' 
= 'B' 
= 'B' 
= 'B' 
= >B' 



3 
4 
5 
6 
10 
1 
2 



Device Driver Load 
Device Driver Unload 
Reconfiguration Status Change 
Message 
CPU Detected Errors 

Unexpected Interrupt 
Unexpected Interrupt 



Subtype code 2 is reserved. Use 3 for the next following Subtype code 

E$CSDE ='B' 11 ; Software Detected Events 
E$SABO ='B' 1 ; Task Abort 

Codes for Context Code entry E$HCTX 



EH$NOR 
EH$STA 
EH$CRS 



= 'B' 
= 'B' 
= ■3' 



Normal Entry 
Start Entry 
Crash Entry 



Codes for Flags entry E$HFLG 



EH$VIR ='B' 

EH$EXT ='B' 

EH$COU ='B' 

EH$QBS ='B' 



1 
2 

4 
10 



Addresses are virtual 
Addresses are extended 
Error counts supplied 
Q-BUS CPU 



Task Subpacket 



I Task Subpacket Length 



I Task Name in RAD50 

+ 

I Task UIC 



I Task TI: Device Name I 

+ + + 

I Flags I Task TI: Unit Number I 



.=0 



E$TLGH: 
E$TTSK: 
E$TUIC: 
E$TTID: 
E$TTIU: 
E$TFLG: 


■L- 
■L" 
•L' 
'L- 
'L- 
'L- 


.BLKW 
-BLKW 
.BLKW 
.6LKB 
.BLKB 
.BLKB 


1 
2 

1 
2 

1 
1 


Task Subpacket Length 

Task Name in RAD50 

Task UIC 

Task TI: Device Name 

Task TI: Unit 

Flags 


E$TLEN: 


'L' 


.EVEN 






; Flags 


for 


entry E$TFLG 






ET$PRV 
ET$PRI 


■B' 
'B' 


1 ; Task is Privileged 

2 ; Terminal is Privileged 



Device Identification Subpacket 



(Continued on next page) 
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Example C-1 (Cont.): Error Log Packet Format 



Device Identification Subpacket Length 
Device Mnemonic Name 



I Controller Number 



Device Unit Number 



Physical Subunit # I Physical Unit # 

+ 

Physical Device Mnemonic 

, + 



Reserved 



I Flags 



Volume Name of Mounted Volume 
Pack Identification 



Device Type Class 
Device Type 



Blocks Transferred Count 
Cylinders Crossed Count 



I/O Operation Count Longword 

, _ + 

Hard Error Count I Soft Error Count 



E$ILGH 
E$ILDV 
ESILUN 
E$IPCO 
E$IPUN 
E$IPSU 


•L' 
•L' 
•L' 
•L' 
'L' 
■L' 


.BLKW 
.BLKW 
.BLKB 
-BLKB 
.BLKB 
.BLKB 




Device Identification Subpac 
Device Mnemonic Name 
Device Unit Number 
Controller Number 
Physical Unit Number 
Physical Subunit Number 






.IF DF R$$MI 


>L 


E$IPDV 


'L- 


.BLKW 


1 


Physical Device Mnemonic 


E$IFLG 
E$IVOL 


•L' 
•L' 


.ENDC 
.BLKB 
.BLKB 
.BLKB 


1 
1 
12. 


R$$MPL 
Flags 
Reserved 
Volume Name 


ESIPAK 
E$IDEV 
E$IDCL 
ESIDTY 
E$IOPR 
E$IERS 
E$IERH 


•L' 
'L' 
•L' 
'L' 
•L' 
■L' 
■L- 


.BLKB 

.BLKW 
.BLKW 
.BLKW 
.BLKB 
.BLKB 


4 

1 
2 
2 

1 
1 


Pack Identification 

Device Type 

Device Type Class 

Device Type 

I/O Operation Count Longword 

Soft Error Count 

Hard Error Count 



(Continued on next page) 



C-6 Error Log Packet Format 



Example C-1 (Cont.): Error Log Packet Format 

.IF DF R$$MPL 

.BLKW 2 : Blocks transferred count 
.BLKW 2 ; Cylinders crossed count 

.ENDC ; R$$MPL 

.EVEN 
E$ILEN:'L' ; Subpacket Length 



E$IBLK:'L 
E$ICYL: 'L 



; Flags for field E$IFL6 

EIISUB ='B' 1 
.IF DF R$$MPL 



= 'B' 2 
.ENDC ; R$iMPL 



EI$NUX 
Device Operation Subpacket 



Subcontroller device 

No UCB extension, data invalid 



+ + 

I Device Operation Subpacket Length I 

+ + 

I Task Name in RAD50 I 

+ + 

I Task UIC I 

+ + 

I Task TI: Logical Device Mnemonic I 

+. + + 

I Reserved I Task TI: Device Unit I 

+ + + 

I I/O Function Code I 

+ + + 

I Reserved I Operation Flags I 

+ + + 

I Transfer Operation Address I 

+ + 

I Transfer Operation Byte Count I 

+ + 

I Current Operation Retry Count I 

+ + 



ElOLGN: 


'L' 


.BLKW 




EIOTSK: 


•L' 


-BLKW 




ElOUIC: 


•L' 


.BLKW 




E$OTID: 


•L' 


.BLKB 




ElOTIU: 


•L' 


.BLKB 








.BLKB 




EtOFNC: 


'L' 


.BLKW 




EtOFLG: 


'L' 


.BLKB 








.BLKB 




E$DADD: 


'L' 


.BLKW 




E$OSIZ: 


'L' 


.BLKW 




EIORTY: 


•L' 


.BLKW 





Subpacket Length 

Task Name in RAD50 

Task UIC 

Task TI: Logical Device Mnemonic 

Task TI: Logical Device Unit 

Reserved 

I/O Function Code 

Operation Flags 

Reserved 

Transfer Operation Address 

Transfer Operation Byte Count 

Current Operation Retry Count 
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Example C-1 (Cont.): Error Log Packet Format 

.EVEN 



E$OLEN:'L' 




Device 


Operation Subpacket Length 


; Flags for field E$OFLG 






EO$TRA 
EOIDMA 
EOIEXT 
EOlPIP 


= 'B' 
= 'B' 
= 'B' 


1 

2 

4 

10 


Transfer Operation 

DMA Device 

Extended Addressing Device 

Device is positioning 



1/0 Activity Subpacket 



I 1/0 Activity Subpacket Length 



.=0 

E|ALGH:'L' .BLKW 1 ; Subpacket Length 

I/O Activity Subpacket Entry 



Logical 


Device Name Mnemonic 






Controll 


er Number 1 


Logical 


Device 


Unit 


Physical 


Subunit # 1 


Physical 


Unit 


Number 


Physical 


Device Mnemonic 






Task Tl: 


logical unit 1 


Device flags 




Requesting Task Name in 


RAD50 






Requesting Task UlC 


Task TI: 


Logical Device 


Name 






I/O Function Code 


Reserved 


1 


Flags 






Transfer 


Operation Address 






Transfer 


Operation Byte 


Count 







=0 
E$ALDV:'L' 
E|ALUN:'L' 
E|APCO:'L' 
E$APUN:'L' 
ElAPSU: 'L' 



.BLKW 1 ; Logical Device Name Mnemonic 

.BLKB 1 ; Logical Device Unit 

.BLKB 1 ; Controller Number 

.BLKB 1 ; Physical Unit Number 

.BLKB 1 ; Physical Subunit Niimber 



(Continued on next page) 



C-8 Error Log Packet Format 



Example C-1 (Cont.): Error Log Packet Format 



E$APDV: 


'L- 


.BLKW 
.ENDC 


1 


E$ADF6: 


■L' 


.BLKB 


1 


E$ATIU: 


'L' 


.BLKB 


1 


E$ATSK: 


•L' 


.BLKW 


2 


E$AUIC: 


•L" 


.BLKW 


1 


E$ATID: 


•L' 


.BLKW 


1 


E$AFNC: 


'L' 


.BLKW 


1 


E$AFL6: 


•L' 


.BLKB 


1 






-BLKB 


1 


E$AADD: 


■L' 


.BLKW 


2 


E$ASIZ: 


'L' 


.BLKW 
.EVEN 


1 


E$AT.EM: 


'L' 




S 



IF DF R$$MPL 

Physical Device Mnemonic 



Device flags 

Task TI: Logical Unit 

Requesting Task Name in RAD50 

Requesting Task UIC 

Task TI: Logical Device Name 

I/O Function Code 

Flags 

Reserved 

Transfer Operation Address 

Transfer Operation Byte Count 



; Subpacket Entry Length 



Flags for field ESADFG 

EA$SUB ='B' 1 

.IF DF R$$MPL 

EA$NUX ='B' 2 
.ENDC ; R$$MPL 

Flags for field E$AFLG 



EA$TRA 
EA$DMA 
EA$EXT 
EA$PIP 


= 'B' 
= "B' 
= 'B' 
= 'B' 


1 

2 

4 

10 


.PSECT 






.MACRO 
.ENDM 


EPKDF$ 


X.Y 


.ENDM 






.IIF NDF S$$YDF 


-LIST 



Subcontroller device 



No UCB extension, data invalid 



Transfer Operation 

DMA Device 

Device has Extended Addressing 

Device is positioning 
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Index 



Action statement 

CFL, 5-30 to 5-31 
Addition binary operator 

CFL expression, 5-14 
Addition precedence class operator 

CFL expression, 5-16 
ANALYZE/ERROR-LOG command 

See also RPT 
command line, 3-3 

defaults, 3-3 

MCR and DCL equivalents, 3-1 

qualifiers, 3-5 
APPEND/ERROR-LOG command, 2-11 

See also /APPEND switch 
/APPEND switch 
ELI, 2-11 

See also APPEND/ERROR_LOG 

command 
DELETE subswitch, 2-11 
Append-to-file operation 

subpacket information, 4-65 
ASCII data type 
CFL, 5-5 



B 



BACKUP.ERR 

error log backup file, 2-3 
Backup file 

error log, 1-4, 2-1, 2-12 
ELI defaults, 2-3 
/BACKUP switch 

ELI, 2-12 
BCD print radix 

CFL, 5-5 



BEGIN-END statement 

CFL, 5-35 
BINARY print radix 

CFL, 5-5 
Bit extraction unary suffix operator 

CFL expression, 5-11 
Bit-to-text translation 

device-level module, 4-7 

user- written module, 4-27, 4-33 
Bitwise AND binary operator 

CFL expression, 5-14 
Bitwise complement unary operator 

CFL expression, 5-15 
Bitwise operator 

CFL expression, 5-14, 5-15, 5-16 
Bitwise OR binary operator 

CFL expression, 5-14 
Bitwise XOR binary operator 

CFL expression, 5-15 
Block-replacement operation 

subpacket information, 4-66 
$BMSET Executive routine, 4-21 
Brief format report, 1-4 

processing, 4-10, 4-17 

RPT, 3-13 
/BRIEF qualifier 

ANALYZE/ERROR_LOG command, 3-13 

See also /FORMAT switch 
BYTE numeric data type 

CFL, 5-5 
BYTE value 

equivalent string, 5-4 



CALDEV Executive routine, 4-26 
CALL statement 
CFL, 5-32 



Index-1 



CASE conditional declaration 

CFL, 5-29 
CASE statement 

CFL, 5-34 
CD A, 1-1 
CFL 

command line 

DEVSMl, 4-11 
comments, 5-3 
data types, 5-4 to 5-8 

numeric, 5-5 to 5-7 

string conversion, 5-4 
declaration 

conditional, 5-28 to 5-30 
CASE, 5-29 
IF, 5-28 

data item, 5-25 

definition, 5-3 

scope, 5-25 

variables, 5-25 
definition, 4-2, 5-2 
error messages 

See ERLCFL report messages 
expression list, 5-38 to 5-39 
expression operand 

literal, 5-9 

variable, 5-9 
expression operators, 5-9 to 5-16 
expressions, 5-3, 5-9 to 5-15 

conditionals, 5-3 

definition, 5-3 

list, 5-3 
expression type 

function, 5-10 

literal, 5-9 

subexpression, 5-9 

variable, 5-9 
file 

command input, 5-3 

data input, 5-3 

error output, 5-4 

report output, 5-3 

user-prompting, 5-3 
format string, 5-41 

control directives, 5-41 

data-formatting directives, 5-42 

formatting directives, 5-41 
functions, 5-16 to 5-25 

computational, 5-20 

conditional, 5-17 

conversion, 5-17, 5-19 

encoding, 5-19 



CFL 

functions (cont'd.) 
format, 5-16 
look-ahead, 5-21 
packet information, 5-22 
report control, 5-22 
RPT control, 5-20 
string-handling, 5-23 
time-handling, 5-24 
user I/O, 5-25 
intermediate form modules, 5-1 
keyword, 5-3 
literal value, 5-9 

See also LITERAL statement 
named variables, 5-8, 5-8 to 5-9 
numeric literals, 5-6 
numeric operators, 5-13 to 5-16 
parsing routines, 4-4 
primitives, 5-1 
print radices, 5-5 
defaults, 5-6 
signalling, 5-39 
spaces and tabs in text, 5-3 
statements, 5-3, 5-25 to 5-40 
action, 5-30 to 5-31 
control, 5-31 to 5-36 
lexical conditionals, 5-35 
table, 5-36, 5-37, 5-38 
user interface 

command mode, 5-42 
option mode, 5-43 
CFL compiler, 1-1, 1-5, 5-1 

user interface, 5-42 
Change-limits operation 

subpacket information, 4-66 
%CND$IF 

CFL conditional function, 5-17 
%CND$SELECT 

CFL conditional function, 5-17 
CNF module, 4-2 
%CNV$BCD 

CFL conversion function, 5-18 
%CNV$BINARY 

CFL conversion function, 5-18 
%CNV$DECIMAL 

CFL conversion function, 5-18 
%CNV$DECIMAL_P 

CFL conversion function, 5-18 
%CNV$HEX 

CFL conversion function, 5-18 
%CNV$MACHINE 

CFL conversion function, 5-19 
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%CNV$OCTAL 

CFL conversion function, 5-18 
%CNfV$RAD50 

CFL conversion function, 5-19 
%CNV$RSX_TIME 

CFL conversion function, 5-19 
%CNV$STRING 

CFL conversion function, 5-19 
%CNV$VMS_TIME 

CFL conversion function, 5-19 
%COD$BCD 

CFL encoding function, 5-19 
%COD$BINARY 

CFL encoding function, 5-20 
%COD$DECIMAL 

CFL encoding function, 5-19 
%COD$HEX 

CFL encoding function, 5-19 
%COD$MACHINE 

CFL encoding function, 5-20 
%COD$OCTAL 

CFL encoding function, 5-19 
%COD$RSX_TIME 

CFL encoding function, 5-20 
%COD$VMS_TIME 

CFL encoding function, 5-20 
%COM$AND 

CFL computational function, 5-20 
%COM$HARDWARE 

CFL computational function, 5-20 
%COM$LONGWORD 

CFL computational function, 5-20 
%COM$NEGATE 

CFL computational function, 5-20 
%COM$NULL 

CFL computational function, 5-20 
/COMMAND qualifier 

ANALYZE/ERROR_LOG command, 3-23 
See also /REPORT switch 
Compilation path 

control file module, 4-11 
Compiler literal declaration, 4-11 
Conditional declaration 

CFL, 5-28 to 5-30 
CONTEXT 

CFL named variable, 5-9 
Control event 

error logging, 4-4 
Control file 

definition, 4-2 

error log, 3-1, 3-2 



Control file (cont'd.) 

universal library, 5-1 
Control File Language 

See CFL 
Control file module, 1-3, 1-5 

architecture, 4-2 

CFL, 5-1 

compilation path, 4-11 

CPU-level, 4-7 
universal, 4-7 

definition, 4-2 

device-level, 4-7 to 4-9 

DIGITAL-supplied, 1-5, A-5 

error log, 3-1, 3-27 

general format, 5-3 

interaction, 4-12 to 4-15 

modifying, 4-12 

non-DIGITAL device, 4-27 

program control flow, 4-9 

recompiling, 4-12 

summary, 4-4 to 4-7 

table of, 2-7 to 2-8 

universal library 

See ERRLOG.ULB 

user- written, 1-5 
Control information code 

event-level dispatching, 4-16 
Control statement 

CFL, 5-31 to 5-36 
Coroutine statement 

user-written module, 4-32 
COUNT 

CFL named variable, 5-9 
CPU-detected error code 

event-level dispatching, 4-16 
CPU-level module, 4-7, 4-11, A-6 
Crash Dump Analyzer 

SeeCDA 
CRASH statement 

CFL, 5-40 
$CRPKT Executive routine, 4-25 
%CTL$CLOSE function 

CFL, 5-21 
%CTL$EOF function 

CFL, 5-21 
%CTL$nLE_STATUS function 

CFL, 5-21 
%CTL$INPUT function 

CFL, 5-21 
%CTL$OPEN function 

CFL, 5-21 



Index-3 



%CTL$STATUS function 

CFL, 5-21 
/CURRENT quaUfier 

SHOW ERROR-LOG command, 2-13 

D 

DATA subpacket, 4-3, 4-4 

See also Dispatcher module 

append-to-file operation, 4-65 

block-replacement operation, 4-66 

change-limits operation, 4-66 

device error, 4-66 

device information messages, 4-66 

driver-load or unload event, 4-68 

listing, 4-65 to 4-68 

memory parity error event, 4-66 

set-backup-file operation, 4-65 

switch-logging-files operation, 4-65 

system-crash event, 4-67 

system-message event, 4-68 

imknovm interrupt event, 4-67 
/DATE switch 

RPT, 3-8 

arguments, 3-9 

processing, 4-4 

DECIMAL print radix 

CFL, 5-5 
DECLARE statement 

CFL, 5-25 
DECODE statement 

CFL, 5-31 
DECREMENT statement 

CFL, 5-30 
DEVICE-ACTIVITY subpacket 

See IO_ACTIVITY subpacket 
DEVICE-ID subpacket, 4-3 

listing, 4-62 
DEVICE_OP subpacket, 4-3 

listing, 4-63 
Device control code 

event-level dispatching, 4-15 
Device control file module, 2-7 to 2-8 
Device error, 1-5, 1-6 

hardware register contents, 1-6 

subpacket information, 4-66 
Device error code 

event-level dispatching, 4-15 
Device error logging, 2-7 to 2-8 

$DVCER routine, 4-23 
Device identification subpacket 

See DEVICE-ID subpacket 



Device information code 

event-level dispatching, 4-15 
Device information message 

subpacket information, 4-66 
Device information table, 4-17, 4-18, 4-35 
Device-level module, 2-7, 4-7 to 4-9, 4-11 

adding to system, 4-27 

bit-to-text translation, 4-7, 4-27, 4-33 

coroutine statement, 4-32 

device data declaration, 4-29 

device name, 4-28 

device registers, 4-29 

error type, 4-32 

example, 4-36 to 4-50 

exiting, 4-34 

flow of, 4-28 

intermodule variables, 4-32 

local work variables, 4-31 

MODULE statement, 4-35 

non-DlGlTAL device, 4-21 

notes requirement, 4-33 

procedures, 4-28 to 4-34 

PROCEDURE statement, 4-29 

register declaration, 4-30 

SUBPACKET declaration, 4-29 

table of, 4-8 

writing, 4-28 to 4-34 
Device name 

notes module, 4-34 

user-written module, 4-28 
Device operation subpacket 

See DEVICE-OP subpacket 
Device register 

device-level modules, 4-29 
/DEVICES qualifier 

ANALYZE/ERROR-LOG command, 3-5, 
3-9 
See also /DEVICE switch 
arguments, 3-9 
/DEVICE switch 

RPT, 3-5, 3-9 

See also /DEVICES qualifier 
arguments, 3-5, 3-9 
processing, 4-4 
Device timeout logging 

$DTOER routine, 4-22 

$DVTMO routine, 4-22 
DEVSMl conti-ol file module, 4-6, 4-11, 

4-17, 4-36, A-5 
DEVUDA conti-ol file module, 2-7, 4-6, 4-11, 
A-5 
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DISPATCH control fUe module, 4-4, 4-9, 
4-10, A-5 

as input symbol file, 4-11 

subpacket declaration, 4-10 
Dispatcher module 

See also DATA subpacket 

DSPIPI, 4-4, 4-11, 4-17, 4-65, A-5 

DSP2P1, 4-5, 4-11, 4-17, 4-66, A-5 

DSP3P1, 4-5, 4-11, 4-17, 4-66, A-5 

DSP4P1, 4-5, 4-11, 4-17, 4-66, A-5 

DSP5P1, 4-5, 4-11, 4-17, 4-21, 4-66, 4-67, 
A-5 

DSP6P1, 4-5, 4-11, 4-17, 4-67, A-5 

DSP7P1, 4-6, 4-11, 4-17, 4-67, 4-68, A-5 

DSP8P1, 4-6, 4-11, 4-17, A-5 

example, 4-50 to 4-59 

subpacket declaration, 4-61 
Dispatching 

CPU-level, 4-5, 4-21 

device-level, 4-17 to 4-21 

event-level, 4-5, 4-15 to 4-17 
Display svritch 

EU, 2-3, 2-12 
Division binary operator 

CFL expression, 5-13 
DMPALL control file module, 4-7, A-5 
DO statement 

CFL, 5-34 
Drive and pack serial number switch 

See /SERIAL switch 
Driver-load or unload event 

subpacket information, 4-68 
Driver support 

non-DIGITAL device, 4-21 
DSPIPI dispatcher module, 4-4, 4-11, 4-17, 
A-5 

DATA subpackets, 4-65 
DSP2P1 dispatcher module, 4-5, 4-11, 4-12 
to 4-15, 4-17, A-5 

DATA subpackets, 4-66 

listing, 4-50 to 4-59 
DSP3P1 dispatcher module, 4-5, 4-11, 4-17, 
A-5 

DATA subpackets, 4-66 
DSP4P1 dispatcher module, 4-5, 4-11, 4-17, 
A-5 

DATA subpackets, 4-66 
DSP5P1 dispatcher module, 4-5, 4-11, 4-17, 
4-21, A-5 

DATA subpackets, 4-66, 4-67 
DSP6P1 dispatcher module, 4-5, 4-11, 4-17, 
A-5 



DSP6P1 dispatcher module (cont'd.) 

DATA subpackets, 4-67 
DSP7P1 dispatcher module, 4-6, 4-11, 4-17, 
A-5 

DATA subpackets, 4-67, 4-68 
DSP8P1 dispatcher module, 4-6, 4-11, 4-17, 

A-5 
$DTOER Executive routine, 4-22 
$DVCER Executive routine, 4-22, 4-23 
$DVERR Executive routine 

See $DVCER Executive routine 
$DVTMO Executive routine, 4-22 
DYNAMIC-TABLE statement 

CR, 5-37 

See also FILE statement 



El 144 CPU-level module, 4-7, A-6 
E117X CPU-level module, 4-7, A-6 
E118X CPU-level module, 4-7, A-6 
EllXX CPU-level module, 4-7, A-6 
Element extraction imary suffix operator 

CFL expression, 5-10 
EU, 1-2, 1-4 
command line 
DCL, 2-2 
defaults, 2-3 
MCR, 2-2 

MCR and DCL equivalents, 2-1 
control packets, 2-6 
error messages, 2-15 to 2-16 
installing, 2-2 
invoking, 2-2 

from any terminal, 2-2 
from privileged terminal, 2-2 
nonprivileged use, 2-2 
privileged use, 2-2 
switches 

display, 2-3, 2-12 
error limiting, 2-3, 2-8, 2-9 
file-naming, 2-3, 2-10 
logging, 2-3, 2-5 
table of, 2-3 to 2-5 
EMLll device-level module, 4-8, A-6 
ENABLE statement 

CFL, 5-39 
/ENTRY qualifier 

ANALYZE/ERROR_LOG command, 3-5, 
3-10 
See also /PACKET switch 
EPKDF.MAC system macro, C-1 
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Equality binary operator 

CFL expression, 5-12 
ERK05 device-level module, 2-8, 4-8, A-6 
ERK67 device-level module, 2-8, 4-8, A-6 
ERL12 device-level module, 2-8, 4-8, A-6 
ERLCFL error messages, 5-44 to 5-55 
ERLCNF error messages, 3-27 to 3-33 
ERLRPT error messages, 3-33 to 3-49 
ERM05 device-level module, 2-8, A-6 
ERM23 device-level module, 2-8, 4-8, 4-12 

to 4-15, 4-36 to 4-50, A-6 
ERM80 device-level module, 2-8, 4-8, A-6 
ERP07 device-level module, 2-8, 4-8, A-6 
ERP23 device-level module, 2-8, 4-8, A-6 
ERP456 device-level module, 2-8, 4-8, A-6 
ERRDEFINE.CFS, 3-23 
ERRLOG, 1-1, 1-3, 1-4 

backup file, 1-4, 2-3 

defaults, 2-3 

error messages, 2-16 to 2-18 

installing, 2-2 

log file, 1-3, 1-4 
ERRLOG.ULB, 2-7, 3-3, 3-29 

universal library, A-1, A-5 
ERROR.MAC, 4-21 
Error limit 

changing, 2-3, 2-9 

default, 2-3 

device mount, 2-9 

error logging, 2-1 

notification, 1-4 

resetting, 1-4, 2-9, 2-10 

starting, 2-5, 2-8 

stopping, 2-5, 2-8 

system reboot, 2-9 
Error log command packet, 1-2 
Error log control code 

event-level dispatching, 4-15 
Error log file, 1-1, 2-1, 2-3, 2-10, 5-1 

appending, 2-11 
new data, 2-5 

backup, 2-1, 2-12 

copying, 2-11 

creating new version, 2-5, 2-11 

default, 2-3 

definition, 4-2 

format, 5-1 

processing, 5-1 
Error Logger task 

See ERRLOG 
Error logging 

code and subcode combinations, 4-15 



Error logging (cont'd.) 

concurrent I/O activity, 4-23, 4-25 

context information, C-1 

control events, 4-4 

CPU errors, 2-6 

device errors, 1-1, 2-6, C-1 

displaying information, 2-12 

error limits, 1-4, 2-1, 2-5, 2-8 

error processing module, 4-6 

error types, 1-5 

event information, 2-1 

events, 1-1, 2-6, 5-2 

Executive support, 1-1, 2-1 

hard errors, 1-3, 2-9 

I/O completion, 4-24 

internal I/O operations, 1-1, 2-6 

interrupt timeouts, 1-6 

men\ory errors, 1-6, 2-6 

non-DIGITAL device, 4-7, 4-21, 4-27 

non-error events, C-1 

nonsense interrupt, 4-23 

resetting counts, 2-9 

root module, 4-4 

soft errors, 1-3, 2-10 

starting, 2-5 

status information, 2-1 

stopping, 2-5, 2-7 

tasks, 1-1 

unexpected traps or interrupts, 1-6, 2-6 

updating, 2-6 

user-written module 

See User-written module 
Error logging device 

See also Control file module 

subpacket information, 4-62 

table of, 2-7 to 2-8 
Error logging task 

subpacket information, 4-62 
Error Log Interface 

See ELI 
Error log packet, 1-1, 1-3, 1-4, 5-1 

creating, 4-24, 4-25 

definition, 4-2 

format, 5-1, C-1 

length word, 4-2 

processing, 5-1 

queueing, 4-24, 4-26 

removing from queue, 4-27 

selection, 2-6 

structure, 4-3, 4-15, 5-2 
Error log subpacket, 5-2 
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ERRORM control file module, 4-6, 4-11, A-6 
Error messages 

CFL, 5-44 to 5-55 

EU, 2-15 to 2-16 

ERRLOG, 2-16 to 2-18 

RPT 

ERLCNF, 3-27 to 3-33 
ERLRPT, 3-33 to 3-49 
ERRORS.ACC, 2-6, 2-13 
ERRORS.LOG, 2-6, 2-12 
ERRORS.LST, 2-13 
ERROR summary report 

processing, 4-6, 4-10 

RPT, 3-21 
Error type, 1-5 

determining with user-written module, 
4-32 
ERRSEQ error sequence number, 1-3 
ERSll device-level module, 2-8, 4-8, A-6 
ERS34 device-level module, 2-8, 4-8, A-6 
ERXOl device-level module, 2-8, 4-8, A-6 
ERX02 device-level module, A-6 
ET0310 device-level module, 2-8, 4-8, A-6 
ET1645 device-level module, 2-8, 4-8, A-6 
ETAll device-level module, 2-8, 4-8, A-6 
ETCH device-level module, 2-8, 4-8, A-6 
ETK50 device-level module, 2-8, 4-8, A-6 
ETK70 device-level module, 4-8, A-6 
ETSll device-level module, 2-8, 4-8, A-6 
ETSV05 device-level module, 2-8, 4-8, A-6 
ETU58 device-level module, 2-8, 4-8, A-6 
ETU60 device-level module, 2-8 
ETU77 device-level module, 2-8, 4-8, A-6 
ETU81 device-level module, 2-8, 4-8, A-6 
EUNKWN control file module, 4-7, A-6 

non-DIGITAL device, 4-21 
Event, 1-1 

definition, 1-3, 4-2 
Event information 

error logging, 2-1 
Event-level dispatching, 4-5, 4-15 to 4-17 

control information code, 4-16 

CPU-detected error code, 4-16 

device control information, 4-15 

device error code, 4-15 

device information code, 4-15 

error log control code, 4-15 

event code, 4-17 

event type, 4-1 7 

format, 4-17 

modules, 4-17 

system control information code, 4-16 



Executive routine, 1-1, 1-3, 1-5, 1-6 

$BMSET, 4-21 

CALDEV, 4-26 

$CRPKT, 4-25 

$DTOER, 4-22 

$DVCER, 4-22 

$DVTMO, 4-22 

SFNfERL, 4-24 

$LOGER, 4-24 

LOGTST, 4-25 

$NSIER, 4-23 

$QERMV, 4-27 

SQUPKT, 4-26 
EXEMC.MLB macro library, 4-15 
Expression 

CFL, 5-9 to 5-15 

list, 5-38 to 5-39 
declaring, 5-39 

operator, 5-9 to 5-16 
precedence, 5-15 

type, 5-9 



HELD data type 

CFL, 5-7 
Field extraction suffix unary operator 

CFL expression, 5-13 
FILE statement 

CFL, 5-37 

See also DYNAMIC-TABLE statement 
FILL print fill character option 

CFL, 5-5 
FIND statement 

CFL, 5-38 
FINLPl control file module, 4-4, 4-6, 4-11, 

A-6 
FMTNPl formatter module, 4-6, 4-10, 4-11, 

4-17, A-6 
FMTWPl formatter module, 4-6, 4-10, 4-11, 

4-17, A-6 
$FNERL Executive routine, 4-24 
Format string 
CFL, 5-41 
/FORMAT switch 
RPT, 3-13 

arguments, 3-13, 3-16, 3-19 
processing, 4-4 
Formatter module, 4-5, 4-6, 4-10, 4-11, 4-17, 

A-6 
Full format report, 1-4, 1-5 
processing, 4-10, 4-17 
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Full format report (cont'd.) 

RPT, 3-13, 3-16 
/FULL qualifier 

ANALYZE/ERROR_LOG command, 
3-13, 3-16 
See also /FORMAT switch 

G 

GEOMETRY summary report 

processing, 4-7, 4-10 

RPT, 3-23 
Greater-than binary operator 

CFL expression, 5-12 
Greater-than-or-equal binary operator 

CFL expression, 5-12 

H 

Handler routine 

CFL signalling, 5-39 
/HARD-LIMIT qualifier 

SET ERROR-LOG command, 2-9 
See also /HL switch 
Hard error, 1-3 

defined, 2-9 
HEADER subpacket, 4-3 

listing, 4-61 

required, 4-10 
HEX print radix 

CFL, 5-5 
Highest precedence class operator 

CFL expression, 5-15 
/HISTORY qualifier 

SHOW ERROR_LOG command, 2-13 
HISTORY sununary report 

processing, 4-7, 4-10 

RPT, 3-23 
/HL switch 

ELL 2-3, 2-9 

See also /HARD_LIMIT qualifier 
with /SL switch, 2-10 



I/O completion 

error logging, 4-24 
I/O operation 

subpacket information, 4-63 
ICF module, 4-2 
IF conditional declaration 

CFL, 5-28 



IF-THEN-ELSE statement 

CFL, 5-33 
/INCLUDE qualifier 

ANALYZE/ERROR_LOG command, 3-5, 
3-11 
See also /TYPE switch 
arguments, 3-11, 3-12 
START/ERROR-LOG command, 2-6 

See also /LOG switch 
INCREMENT statement 

CFL, 5-30 
Indirect command file 

TUNE.CMD, 2-7, A-1 
Inequality binary operator 

CFL expression, 5-12 
INITMl control file module, 4-4, 4-33, A-6 
INITPl control file module, 4-11 
Intermodule variable 

block number, 4-32 

cylinder error, 4-32 

declaration, 4-13 

device function, 4-32 

drive serial number, 4-32 

drive type, 4-32 

error type, 4-32 

group error, 4-32 

head error, 4-32 

physical unit number, 4-32 

sector error, 4-32 

user-written modvile, 4-32 
Interrupt 

unexpected, 1-6 
Interrupt timeout, 1-6 
IO_ACTIVITY subpacket, 4-3 

listing, 4-64 



LBR 

module name requirement, 4-16 
LEAVE statement 

CFL, 5-35 
LENGTH 

CFL named variable, 5-9 
Less-than binary operator 

CFL expression, 5-12 
Less-than-or-equal binary operator 

CFL expression, 5-12 
Librarian Program Utility 

See LBR 
/UMTTING qualifier 

SET ERROR-LOG command, 2-9 
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/LIMITING qualifier 

SET ERROR-LOG command (cont'd.) 

See also /LIMIT switch 
START/ERROR_LOG command, 2-3 

See also /LOG switch 
/-LIMIT switch 

ELL 2-9 

See also /NOLIMITING qualifier 
/LIMIT switch 

EU, 2-9 

See also /LIMITING qualifier 
LIST statement 

CFL, 5-39 
Literal declaration 

compile-time, 4-11 
LITERAL statement 

CFL, 5-32 
Literal value 

CFL, 5-9 
Local work variable 

user- written module, 4-31 
LOG.ERR 

error log file, 2-3, 2-5 

RPT input file, 3-3 
$LOGER Executive routine, 4-24 
Logical AND binary operator 

CFL expression, 5-11 
LOGICAL data type 

CFL, 5-4 
Logical NOT unary prefix operator 

CFL expression, 5-11 
Logical operator 

CFL expression, 5-11, 5-16 
Logical OR binary operator 

CFL expression, 5-11 
Logical SHIFT binary operator 

CFL expression, 5-13 
Logical unit number 

See LUN 
Logical XOR binary operator 

CFL expression, 5-11 
/LOG switch 

ELL 2-3, 2-5, 2-10 

See also START/ERROR_LOG 

command 
error limiting, 2-3, 2-5 
file naming, 2-10 
starting logging, 2-5 
subswitches, 2-5, 2-6, 2-7, 2-13 
LOGTST Executive routine, 4-25 



%LOK$BYTE 

CFL look-ahead function, 5-21 
%LOK$LENGTH 

CFL look-ahead function, 5-22 
%LOK$LONGWORD 

CFL look-ahead function, 5-21 
%LOK$WORD 

CFL look-ahead function, 5-21 
LONGWORD numeric data type 

CFL, 5-5 
LONGWORD value 

equivalent string, 5-4 
LST module, 4-2 
LUN 

calculation, 4-26 

M 

MACHINE radix 

CFL, 5-6 
MASSBUS 

device-level module, 4-35 
mixed configuration, 4-35 
Memory error, 1-6 
Memory parity error event 

subpadcet information, 4-66 
MESSAGE statement 

CFL, 5-40 
Module 
control file 

See Control file module 
CPU-level 

See CPU-level module 
device-level 

See Device-level module 
dispatcher 

See Dispatcher-level module 
formatter 

See Formatter module 
notes 

See Notes module 
user-written 

See User-written module 
Module name 

LBR requirement, 4-16 
MODULE statement 
CFL, 5-31 

NOTES module, 4-34 
user-written module, 4-28 
Modulus binary operator 
CFL expression, 5-14 
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MSCP5X device-level module, 2-7, 2-8, 4-8, 

A-6 
MSCP60 device-level module, 2-7, 4-8, A-6 
MSCP80 device-level module, 4-8, A-6 
MSCPAT device-level module, 2-7, 4-8, A-6 
MSCPCE device-level module, 2-7, 4-9, A-6 
MSCP DU-type devices, 4-6 
MSCPEN device-level module, 2-7, 4-9, A-6 
MSCPSD device-level module, 2-7, 4-9, A-6 
MSCPTO device-level module, 2-7, 4-9, A-6 
Multiplication binary operator 

CFL expression, 5-13 
Multiplication precedence class operator 

CFL expression, 5-16 

N 

Named variable 

CFL, 5-8 to 5-9 
Negation unary prefix operator 

CFL expression, 5-14 
/NEW_LOG_FILE qualifier 

SET ERROR-LOG command, 2-11 
See also /SWITCH switch 
/NEW_VERSION qualifier 

SET ERROR_LOG command, 2-4, 2-11 

START/ERROR_LOG command, 2-4, 2-5 
NMLll notes module, 4-9, A-7 
/NODETAIL qualifier 

ANALYZE/ERROR-LOG command, 
3-13, 3-19 
See also /FORMAT switch 
/NOLIMITING qualifier 

SET ERROR_LOG command, 2-9 
See also /-LIMIT switch 

START/ERROR_LOG command, 2-5 
See also /LOG switch 
/NOLOG switch 

ELL 2-7, 2-9 

See also STOP/ERROR_LOG 
command 
Non-DIGITAL device 

driver support, 4-21 

error logging, 4-27 
Nonsense interrupt logging, 4-23 
No report format 

RPT, 3-19 
Notes module 

device name, 4-34 

example, 4-60 to 4-61 

exiting, 4-35 

flow of, 4-34 



Notes module (cont'd.) 

heading, 4-35 

MODULE statement, 4-34 

naming requirements, 4-34 

printing, 4-35 

procedures, 4-34 to 4-35 

PROCEDURE statement, 4-34 

table of, 4-9 

trapping imknown numbers, 4-35 

writing, 4-34 to 4-35 
NRK67 notes module, 4-9, A-7 
NRM05 notes module, 4-9, A-7 
NRM23 notes module, 4-9, 4-60 to 4-61, A-7 
$NS1ER Executive routine, 4-23 
NT0310 notes module, 4-9, A-7 
NTSll notes module, 4-9, A-7 
Numeric data type 

CFL, 5-5 to 5-7 
Niuneric literal 

CFL, 5-6 
Numeric operator 

CFL expression, 5-13 to 5-16 
binary, 5-16 

o 

OCTAL print radix 

CFL, 5-5 
Operator 

CFL expression, 5-9 to 5-16 
/OUTPUT qualifier 

SHOW ERROR-LOG command, 2-13 
See also /SHOW switch 



Packet identification number, 3-1, 3-4, 3-6, 

3-10 
Packet selection 
EU, 2-6 

all packets, 2-6 
control packets, 2-6 
CPU events, 2-6 
default, 2-6 
memory events, 2-6 
peripheral devices, 2-6 
system events, 2-6 
RPT, 3-8, 3-11 
PACKET statement 

CFL, 5-27 
/PACKET switch 
RPT, 3-5, 3-10 

See also /ENTRY qualifier 
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/PACKET switch 
RPT (cont'd.) 

multiple arguments, 3-5 
processing, 4-4 
PARSIM control aie module, 4-4, 4-11, A-7 
PARS2M control file module, 4-4, 4-11, A-7 
PARS3M control file module, 4-4, 4-11, A-7 
PARSEM control file module, 3-23, 4-4, 

4-11, A-7 
%PKT$IDENT 

CFL packet information function, 5-22 
%PKT$MODULE 

CFL packet information function, 5-22 
POINTER 

CFL named variable, 5-9 
POINTER data type 

CFL, 5-7 
POINTER statement 

CFL, 5-37 
Power recovery event 

DSP6P1 dispatcher module, 4-67 
/PREVIOUS-DAYS qualifier 

ANALYZE/ERROR_LOG command, 3-9 

See also /DATE switch 
Print formatting 

CFL, 5-40 to 5-42 
PROCEDURE statement 

CFL, 5-33 

NOTES module, 4-34 

user-written module, 4-29 
PRS2AM control file module, 4-4, 4-11, A-7 
PRS2BM control file module, 4-4, 4-11, A-7 
PUT statement, 4-33 

CFL, 5-38 

Q 

$QERMV Executive routine, 4-27 
QIO count 

ELL 2-9, 2-10 

See also /RESET switch 
QUADWORD numeric data type 

CFL, 5-5 
QUADWORD value 

equivalent string, 5-4 
$QUPKT Executive routine, 4-26 

R 

RAD50 print radix 

CFL, 5-5 
/RECENT qualifier 

SHOW ERROR-LOG command, 2-13 



Register declaration 

user-written module, 4-30 
Register format report 

processing, 4-10 
Register report 

RPT, 3-13, 3-19 
/REGISTERS qualifier 

ANALYZE/ERROR_LOG command, 
3-13, 3-19 
See also /FORMAT switch 
Relational operator 

CFL expression, 5-11 to 5-13, 5-16 
Report Generator Task 

See RPT 
Report Generator task 

See RPT 
/REPORT switch 

RPT, 3-23, 3-26 

See also /COMMAND qualifier 
strings, 3-26 
/RESET_COUNTS qualifier 

SET ERROR_LOG command, 2-10 
See also /RESET switch 
/RESET switch 

ELL 2-9, 2-10 

See also /RESET_COUNTS qualifier 
Resource Monitoring Display 

See RMD 
RETURN statement, 4-34 

CFL, 5-33 
RM02/03 module 

See ERM23 device-level module 
See NRM23 notes modtile 
RM05 device-level module, 4-8 
RMD, 1-3, 2-9 
Root module 

error logging, 4-4 
RPT, 1-3, 1-4, 2-3 

See also ANALYZE/ERROR-LOG 

command 
command line 
DCL, 3-2, 3-3 
defaults, 3-2 

information required, 3-2 
input file, 3-3 
MCR, 3-1, 3-2 

MCR and DCL equivalents, 3-1 
parsing module, 4-4 
repKJrt file, 3-3 
universal library, 3-2 
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RPT 

command line (cont'd.) 

using multiple arguments, 3-5, 3-9, 
3-10, 3-11, 3-12, 3-21 

context information, 1-5 

control file modules, 1-3 

data types, 5-26 

default file specification, 3-2, 3-4 

device-supplied information, 1-5 

error log packet, 3-1 

error messages, 3-27 to 3-49 

format selection, 3-2, 3-4, 3-13 

installing, 2-1, 3-2 

interpreter, 5-1 

packet selection, 3-2, 3-4 

report formats, 1-4 

report types, 1-4 

summary selection, 3-2, 3-4 

switches 

defined report, 3-23 
packet selection, 3-8, 3-11 
report format, 3-13 
summary report, 3-21, 3-23 
table of, 3-6 to 3-8 
width, 3-27 
%RPT$COMMAND 

CFL report control function, 5-22 
%RPT$IDENT 

CFL report control function, 5-22 
%RPT$L1NE -REMAINING 

CFL report control function, 5-22 
%RPT$LINE_SKIP 

CFL report control function, 5-22 
%RPT$P AGE -CURRENT 

CFL report control function, 5-22 
%RPT$PAGE_DEFAULT 

CFL report control function, 5-22 
%RPT$PAGE -REMAINING 

CFL report control function, 5-22 
%RPT$PAGE_SIZE 

CFL report control function, 5-22 
%RPT$STATUS 

CFL report control function, 5-23 
RPTBLD.BLD file, 3-3 
RPT report format 

See also /FORMAT switch 

brief, 1-4, 3-13 to 3-16 
processing, 4-10, 4-17 

full, 3-13, 3-16 to 3-19 
processing, 4-10, 4-17 

no report, 3-19 

register, 3-13, 3-19 



RPT summary report 
ERROR, 3-21, 4-6 
GEOMETRY, 3-23, 4-7 
HISTORY, 3-23, 4-7 
processing, 4-6, 4-10, 4-17 

RSX_TIME data type 
CFL, 5-8 

RX02 device-level module, 4-8 



SEARCH statement 

CFL, 5-39 
SELECT statement, 4-35 

CFL, 5-34 
SELTMl control file module, 4-4, 4-11, A-7 
/SERIAL -NUMBER qualifier 

ANALYZE/ERROR-LOG command, 3-5, 
3-11 
See also /SERIAL switch 
arguments, 3-11 
Serial number 

RPT, 3-5, 3-7, 3-11 

significant digits, B-1 
/SERIAL switch 
RPT, 3-5, 3-11 

See also /SERIAL -NUMBER qualifier 
arguments, 3-5, 3-11 
processing, 4-4 
Set-backup-file operation 

subpacket information, 4-65 
SET ERROR-LOG command, 2-4 

qualifiers, 2-4, 2-9 to 2-10, 2-11 to 2-13 
SET statement 

CFL, 5-30 
SHOW ERROR-LOG command, 2-2, 2-12 
See also /SHOW switch 
nonprivileged command, 2-2 
qualifiers, 2-13 
/SHOW switch 
EU, 2-2, 2-12 

See also SHOW ERROR-LOG 

command 
example, 2-13 to 2-14 
nonprivileged command, 2-2 
subswitches, 2-13 
SIGNAL -STOP statement 

CFL, 5-40 
Signalling 

CFL, 5-39 
SIGNAL statement 
CFL, 5-40 
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/SINCE qualifier 

ANALYZE/ERROR_LOG command, 3-9 

See also /DATE switch 
/SL switch 
ELI, 2-3, 2-10 

See also /SOFT-LIMIT qualifier 
with /HL switch, 2-10 
SMRYEP control file module, 4-6, 4-11, A-7 
SMRYGP control file module, 4-7, 4-11, A-7 
SMRYHP control file module, 4-7, 4-11, A-7 
SMSG$ directive, 1-4 
/SOFE-UMIT quaUfier 

SET ERROR_LOG command, 2-10 
See also /SL switch 
Soft error, 1-3 

defined, 2-10 
SSM command, 1-3 

START/ERROR_LOG command, 2-3, 2-5, 
2-10 
See also /LOG switch 
qualifiers, 2-5 
/STATISTICS qualifier 

ANALYZE/ERROR_LOG command, 3-5, 
3-21 
See also /SUMMARY switch 
arguments, 3-21, 3-23 
Status information 

error logging, 2-1 
STOP/ERROR_LOG command, 2-7, 2-9 

See also /NOLOG switch 
%STR$CHAR 

CFL string-handling function, 5-24 
%STR$nLE 

CFL string-handling fuivction, 5-24 
%STR$LENGTH 

CFL string-handling function, 5-23 
%STR$MATCH 

CFL string-handling function, 5-24 
%STR$PAD 

CFL string-handling function, 5-24 
%STR$PARSE 

CFL string-handling function, 5-23 
%STR$QUOTE 

CFL string-handling function, 5-23 
%STR$REMA1NING 

CFL string-handling function, 5-24 
%STR$SEARCH 

CFL string-handling function, 5-24 
%STR$TRAIL 

CFL string-handling function, 5-23 



%STR$UPCASE 

CFL string-handling function, 5-24 
String concatenation binary operator 

CFL expression, 5-10 
String conversion 

CFL, 5-4 
STRING data type 

CFL, 5-4 

numeric values 
equivalent, 5-4 
String declaration 

CFL, 5-4 
String-matching binary operator 

CFL expression, 5-13 
String operator 

CFL expression, 5-10 
Subpacket 

DATA, 4-3, 4-4, 4-65 to 4-68 

declaration, 4-10, 4-61 

definition, 4-2 

DEVICE_ID, 4-3, 4-62 

DEVICE_OP, 4-3, 4-63 

error log, 5-2 

HEADER, 4-3 

required, 4-10, 4-61 

information in, 4-61 to 4-68 

IO_ACTIVITY, 4-3, 4-64 

TASK, 4-3, 4-62 
SUBPACKET declaration 

user-written module, 4-29 
SUBPACKET statement 

CFL, 5-28 
Substring extraction unary suffix operator 

CFL expression, 5-10 
Subtraction binary operator 

CFL expression, 5-14 
Summary report 

RPT, 3-21 to 3-23 

See also /SUMMARY switch 
/SUMMARY switch 

RPT, 3-5, 3-21 

See also /STATISTICS qualifier 
arguments, 3-5, 3-21, 3-23 
processing, 4-4 
Switch-logging-file operation 

subpacket information, 4-65 
Switch string 

user-defined, 3-26 
/SWITCH switch 

EU, 2-11 

See also /NEW_LOG_FILE qualifier 
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/SWITCH switch 

ELI (cont'd.) 

New Version subswitch, 2-11 
System characteristic 

subpacket information, 4-61 
System control information code 

event-level dispatching, 4-16 
System-crash event 

subpacket information, 4-67 
System-message event 

subpacket information, 4-68 
System Service Message command 

See SSM command 



Table 

CFL, 5-36, 5-37, 5-38 

RPT, 5-36 

See also TABLE statement 
TABLE statement 

CFL, 5-36 
TASK subpacket, 4-3 

listing, 4-62 
%TIM$RSX -CURRENT 

CFL time-handling function, 5-24 
%TIM$RSX_DATE 

CFL time-handling function, 5-24 
%TIM$RSX_NULL 

CFL time-handling function, 5-24 
%TIM$RSX_VMS 

CFL time-handling function, 5-24 
%TIM$VMS_CURRENT 

CFL time-handling function, 5-25 
%TIM$VMS_DATE 

CFL time-handling function, 5-25 
%TIM$VMS_MINUS 

CFL time-handling function, 5-25 
%TIM$VMS_NULL 

CFL time-handling function, 5-25 
%TIM$ VMS-PLUS 

CFL time-handling function, 5-25 
%TIM$VMS_RSX 

CFL time-handling function, 5-25 
TMSCPE device-level module, 4-9, A-7 
/TODAY qualifier 

ANALYZE/ERROR-LOG command, 3-9 
See also /DATE switch 
Trap 

unexpected, 1-6 
TUNE.CMD, 2-7, A-1 



/TYPE switch 
RPT, 3-5, 3-11 

See also /INCLUDE qualifier 
arguments, 3-5, 3-11, 3-12 
processing, 4-4 

u 

Universal library, A-1, A-5 

ERRLOG.ULB, 2-7, 3-3, 3-29 
Unknown interrupt event 

subpacket information, 4-67 
UNTIL statement 

CFL, 5-34 
/UPDATE qualifier 

START/ERROR-LOG command, 2-6 
USERCM, 3-3 
User- written module 

bit-to-text translation, 4-27, 4-33 

coroutine statement, 4-32 

determining error type, 4-32 

exiting, 4-34 

intermodule variables, 4-32 

local work variables, 4-31 

naming requirements, 4-28 

notes requirement, 4-33 

procedures, 4-28 to 4-34 

register declaration, 4-30 

SUBPACKET declaration, 4-29 
%USR$STRING 

CFL user I/O function, 5-25 

y 

VALUE numeric data type 

CFL, 5-5 
Variable, named 

CFL, 5-8 
VMS_TIME data type 

CFL, 5-8 
/VOLUME-LABEL qualifier 

ANALYZE/ERROR-LOG command, 3-12 
See also /VOLUME switch 
/VOLUME switch 
RPT, 3-12 

See also /VOLUME_LABEL qualifier 
processing, 4-4 

w 



WHILE statement 
CFL, 5-34 
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/WIDE qualifier 

ANALYZE/ERROR_LOG command, 3-27 
See also /WIDTH switch 
arguments, 3-27 
WIDTH print field width option 

CFL, 5-5 
/WIDTH switch 
RPT, 3-27 

See also /WIDE qualifier 
arguments, 3-27 
processing, 4-4 
WORD numeric data type 

CFL, 5-5 
WORD value 

equivalent string, 5-4 
WRITE_GROUP statement, 4-33 

CFL, 5-26, 5-31, 5-41 
WRITE statement, 4-33 
CFL, 5-30, 5-41 



/YESTERDAY qualifier 

ANALYZE/ERROR_LOG command, 3-9 
See also /DATE switch 

z 

/ZERO qualifier 

START/ERROR_LOG command, 2-7 
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RSX-llM-PLUS and Micro/RSX 

Error Logging Manual 

AA-JS19A-TC 



READER'S ^ou"^ comments and suggestions are welcome and will help us in our 

^^/->ikiiikiirMTc continuous effort to improve the quality and usefulness of our documentation 

COMMENTS and software. 

Remember, the system includes information that you read on your terminal: 
help files, error messages, prompts, and so on. Please let us know if you have 
comments about this information, too. 

Did you find this manual understandable, usable, and well organized? Please make suggestions fc»- 
improvement. 



Did you find errors in this manual? If so, specify the error and the page number. 



What kind of user are you? Programmer Nonprogrammer 

Years of experience as a computer programmer/user: 

Name ___^ Date 

Organization __^ __„ 

Street . ^ ^ , 

City State Zip Code . 

or Country 
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